From e9eb6c3dd59c0be7a10c3367a5e725c9f31eaa81 Mon Sep 17 00:00:00 2001 From: Backend IM Bot <> Date: Sat, 22 Mar 2025 10:11:55 +0100 Subject: [PATCH] Update generated backend for blog_app with entities: posts, comments, tags, user --- .../site/python3.12/greenlet/greenlet.h | 164 + .../typing_extensions.cpython-312.pyc | Bin 0 -> 139417 bytes .../annotated_types-0.7.0.dist-info/INSTALLER | 1 + .../annotated_types-0.7.0.dist-info/METADATA | 295 + .../annotated_types-0.7.0.dist-info/RECORD | 10 + .../annotated_types-0.7.0.dist-info/WHEEL | 4 + .../licenses/LICENSE | 21 + .../site-packages/annotated_types/__init__.py | 432 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 18644 bytes .../__pycache__/test_cases.cpython-312.pyc | Bin 0 -> 13257 bytes .../site-packages/annotated_types/py.typed | 0 .../annotated_types/test_cases.py | 151 + .../anyio-4.9.0.dist-info/INSTALLER | 1 + .../anyio-4.9.0.dist-info/LICENSE | 20 + .../anyio-4.9.0.dist-info/METADATA | 105 + .../anyio-4.9.0.dist-info/RECORD | 88 + .../site-packages/anyio-4.9.0.dist-info/WHEEL | 5 + .../anyio-4.9.0.dist-info/entry_points.txt | 2 + .../anyio-4.9.0.dist-info/top_level.txt | 1 + .venv/Lib/site-packages/anyio/__init__.py | 85 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3601 bytes .../__pycache__/from_thread.cpython-312.pyc | Bin 0 -> 24067 bytes .../__pycache__/lowlevel.cpython-312.pyc | Bin 0 -> 6989 bytes .../__pycache__/pytest_plugin.cpython-312.pyc | Bin 0 -> 13379 bytes .../to_interpreter.cpython-312.pyc | Bin 0 -> 9119 bytes .../__pycache__/to_process.cpython-312.pyc | Bin 0 -> 11814 bytes .../__pycache__/to_thread.cpython-312.pyc | Bin 0 -> 2962 bytes .../site-packages/anyio/_backends/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 213 bytes .../__pycache__/_asyncio.cpython-312.pyc | Bin 0 -> 132431 bytes .../__pycache__/_trio.cpython-312.pyc | Bin 0 -> 70334 bytes .../site-packages/anyio/_backends/_asyncio.py | 2816 ++++++ .../site-packages/anyio/_backends/_trio.py | 1334 +++ .../Lib/site-packages/anyio/_core/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 209 bytes .../_asyncio_selector_thread.cpython-312.pyc | Bin 0 -> 8424 bytes .../__pycache__/_eventloop.cpython-312.pyc | Bin 0 -> 6367 bytes .../__pycache__/_exceptions.cpython-312.pyc | Bin 0 -> 6076 bytes .../_core/__pycache__/_fileio.cpython-312.pyc | Bin 0 -> 41633 bytes .../__pycache__/_resources.cpython-312.pyc | Bin 0 -> 951 bytes .../__pycache__/_signals.cpython-312.pyc | Bin 0 -> 1294 bytes .../__pycache__/_sockets.cpython-312.pyc | Bin 0 -> 31525 bytes .../__pycache__/_streams.cpython-312.pyc | Bin 0 -> 2357 bytes .../__pycache__/_subprocesses.cpython-312.pyc | Bin 0 -> 9649 bytes .../_synchronization.cpython-312.pyc | Bin 0 -> 32180 bytes .../_core/__pycache__/_tasks.cpython-312.pyc | Bin 0 -> 7009 bytes .../__pycache__/_tempfile.cpython-312.pyc | Bin 0 -> 28153 bytes .../__pycache__/_testing.cpython-312.pyc | Bin 0 -> 3589 bytes .../__pycache__/_typedattr.cpython-312.pyc | Bin 0 -> 3854 bytes .../anyio/_core/_asyncio_selector_thread.py | 167 + .../site-packages/anyio/_core/_eventloop.py | 166 + .../site-packages/anyio/_core/_exceptions.py | 126 + .../Lib/site-packages/anyio/_core/_fileio.py | 742 ++ .../site-packages/anyio/_core/_resources.py | 18 + .../Lib/site-packages/anyio/_core/_signals.py | 27 + .../Lib/site-packages/anyio/_core/_sockets.py | 792 ++ .../Lib/site-packages/anyio/_core/_streams.py | 52 + .../anyio/_core/_subprocesses.py | 202 + .../anyio/_core/_synchronization.py | 732 ++ .venv/Lib/site-packages/anyio/_core/_tasks.py | 158 + .../site-packages/anyio/_core/_tempfile.py | 616 ++ .../Lib/site-packages/anyio/_core/_testing.py | 78 + .../site-packages/anyio/_core/_typedattr.py | 81 + .venv/Lib/site-packages/anyio/abc/__init__.py | 55 + .../abc/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2244 bytes .../__pycache__/_eventloop.cpython-312.pyc | Bin 0 -> 14989 bytes .../__pycache__/_resources.cpython-312.pyc | Bin 0 -> 1656 bytes .../abc/__pycache__/_sockets.cpython-312.pyc | Bin 0 -> 9881 bytes .../abc/__pycache__/_streams.cpython-312.pyc | Bin 0 -> 8460 bytes .../__pycache__/_subprocesses.cpython-312.pyc | Bin 0 -> 3264 bytes .../abc/__pycache__/_tasks.cpython-312.pyc | Bin 0 -> 4540 bytes .../abc/__pycache__/_testing.cpython-312.pyc | Bin 0 -> 2859 bytes .../Lib/site-packages/anyio/abc/_eventloop.py | 376 + .../Lib/site-packages/anyio/abc/_resources.py | 33 + .venv/Lib/site-packages/anyio/abc/_sockets.py | 194 + .venv/Lib/site-packages/anyio/abc/_streams.py | 203 + .../site-packages/anyio/abc/_subprocesses.py | 79 + .venv/Lib/site-packages/anyio/abc/_tasks.py | 101 + .venv/Lib/site-packages/anyio/abc/_testing.py | 65 + .venv/Lib/site-packages/anyio/from_thread.py | 527 + .venv/Lib/site-packages/anyio/lowlevel.py | 161 + .venv/Lib/site-packages/anyio/py.typed | 0 .../Lib/site-packages/anyio/pytest_plugin.py | 272 + .../site-packages/anyio/streams/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 211 bytes .../__pycache__/buffered.cpython-312.pyc | Bin 0 -> 6140 bytes .../streams/__pycache__/file.cpython-312.pyc | Bin 0 -> 7546 bytes .../__pycache__/memory.cpython-312.pyc | Bin 0 -> 14962 bytes .../__pycache__/stapled.cpython-312.pyc | Bin 0 -> 7522 bytes .../streams/__pycache__/text.cpython-312.pyc | Bin 0 -> 8316 bytes .../streams/__pycache__/tls.cpython-312.pyc | Bin 0 -> 17581 bytes .../site-packages/anyio/streams/buffered.py | 119 + .venv/Lib/site-packages/anyio/streams/file.py | 148 + .../Lib/site-packages/anyio/streams/memory.py | 317 + .../site-packages/anyio/streams/stapled.py | 141 + .venv/Lib/site-packages/anyio/streams/text.py | 147 + .venv/Lib/site-packages/anyio/streams/tls.py | 352 + .../Lib/site-packages/anyio/to_interpreter.py | 218 + .venv/Lib/site-packages/anyio/to_process.py | 258 + .venv/Lib/site-packages/anyio/to_thread.py | 69 + .../click-8.1.8.dist-info/INSTALLER | 1 + .../click-8.1.8.dist-info/LICENSE.txt | 28 + .../click-8.1.8.dist-info/METADATA | 74 + .../click-8.1.8.dist-info/RECORD | 38 + .../site-packages/click-8.1.8.dist-info/WHEEL | 4 + .venv/Lib/site-packages/click/__init__.py | 75 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2756 bytes .../click/__pycache__/_compat.cpython-312.pyc | Bin 0 -> 27467 bytes .../__pycache__/_termui_impl.cpython-312.pyc | Bin 0 -> 30602 bytes .../__pycache__/_textwrap.cpython-312.pyc | Bin 0 -> 2463 bytes .../__pycache__/_winconsole.cpython-312.pyc | Bin 0 -> 12002 bytes .../click/__pycache__/core.cpython-312.pyc | Bin 0 -> 135717 bytes .../__pycache__/decorators.cpython-312.pyc | Bin 0 -> 24753 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 14903 bytes .../__pycache__/formatting.cpython-312.pyc | Bin 0 -> 14077 bytes .../click/__pycache__/globals.cpython-312.pyc | Bin 0 -> 3135 bytes .../click/__pycache__/parser.cpython-312.pyc | Bin 0 -> 21507 bytes .../shell_completion.cpython-312.pyc | Bin 0 -> 22913 bytes .../click/__pycache__/termui.cpython-312.pyc | Bin 0 -> 32812 bytes .../click/__pycache__/testing.cpython-312.pyc | Bin 0 -> 24779 bytes .../click/__pycache__/types.cpython-312.pyc | Bin 0 -> 49508 bytes .../click/__pycache__/utils.cpython-312.pyc | Bin 0 -> 26383 bytes .venv/Lib/site-packages/click/_compat.py | 623 ++ .venv/Lib/site-packages/click/_termui_impl.py | 788 ++ .venv/Lib/site-packages/click/_textwrap.py | 49 + .venv/Lib/site-packages/click/_winconsole.py | 279 + .venv/Lib/site-packages/click/core.py | 3047 ++++++ .venv/Lib/site-packages/click/decorators.py | 562 ++ .venv/Lib/site-packages/click/exceptions.py | 296 + .venv/Lib/site-packages/click/formatting.py | 301 + .venv/Lib/site-packages/click/globals.py | 67 + .venv/Lib/site-packages/click/parser.py | 531 + .venv/Lib/site-packages/click/py.typed | 0 .../site-packages/click/shell_completion.py | 603 ++ .venv/Lib/site-packages/click/termui.py | 784 ++ .venv/Lib/site-packages/click/testing.py | 483 + .venv/Lib/site-packages/click/types.py | 1093 +++ .venv/Lib/site-packages/click/utils.py | 624 ++ .../colorama-0.4.6.dist-info/INSTALLER | 1 + .../colorama-0.4.6.dist-info/METADATA | 441 + .../colorama-0.4.6.dist-info/RECORD | 31 + .../colorama-0.4.6.dist-info/WHEEL | 5 + .../licenses/LICENSE.txt | 27 + .venv/Lib/site-packages/colorama/__init__.py | 7 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 506 bytes .../colorama/__pycache__/ansi.cpython-312.pyc | Bin 0 -> 3959 bytes .../__pycache__/ansitowin32.cpython-312.pyc | Bin 0 -> 16426 bytes .../__pycache__/initialise.cpython-312.pyc | Bin 0 -> 3564 bytes .../__pycache__/win32.cpython-312.pyc | Bin 0 -> 8149 bytes .../__pycache__/winterm.cpython-312.pyc | Bin 0 -> 9102 bytes .venv/Lib/site-packages/colorama/ansi.py | 102 + .../Lib/site-packages/colorama/ansitowin32.py | 277 + .../Lib/site-packages/colorama/initialise.py | 121 + .../site-packages/colorama/tests/__init__.py | 1 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 212 bytes .../__pycache__/ansi_test.cpython-312.pyc | Bin 0 -> 5481 bytes .../ansitowin32_test.cpython-312.pyc | Bin 0 -> 18020 bytes .../initialise_test.cpython-312.pyc | Bin 0 -> 11668 bytes .../__pycache__/isatty_test.cpython-312.pyc | Bin 0 -> 4795 bytes .../tests/__pycache__/utils.cpython-312.pyc | Bin 0 -> 2484 bytes .../__pycache__/winterm_test.cpython-312.pyc | Bin 0 -> 6626 bytes .../site-packages/colorama/tests/ansi_test.py | 76 + .../colorama/tests/ansitowin32_test.py | 294 + .../colorama/tests/initialise_test.py | 189 + .../colorama/tests/isatty_test.py | 57 + .../Lib/site-packages/colorama/tests/utils.py | 49 + .../colorama/tests/winterm_test.py | 131 + .venv/Lib/site-packages/colorama/win32.py | 180 + .venv/Lib/site-packages/colorama/winterm.py | 195 + .../fastapi-0.115.11.dist-info/INSTALLER | 1 + .../fastapi-0.115.11.dist-info/METADATA | 565 ++ .../fastapi-0.115.11.dist-info/RECORD | 97 + .../fastapi-0.115.11.dist-info/REQUESTED | 0 .../fastapi-0.115.11.dist-info/WHEEL | 4 + .../entry_points.txt | 5 + .../licenses/LICENSE | 21 + .venv/Lib/site-packages/fastapi/__init__.py | 25 + .venv/Lib/site-packages/fastapi/__main__.py | 3 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1121 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 267 bytes .../__pycache__/_compat.cpython-312.pyc | Bin 0 -> 27895 bytes .../__pycache__/applications.cpython-312.pyc | Bin 0 -> 84135 bytes .../__pycache__/background.cpython-312.pyc | Bin 0 -> 2393 bytes .../fastapi/__pycache__/cli.cpython-312.pyc | Bin 0 -> 681 bytes .../__pycache__/concurrency.cpython-312.pyc | Bin 0 -> 1694 bytes .../datastructures.cpython-312.pyc | Bin 0 -> 8166 bytes .../__pycache__/encoders.cpython-312.pyc | Bin 0 -> 10916 bytes .../exception_handlers.cpython-312.pyc | Bin 0 -> 2095 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 7181 bytes .../__pycache__/logger.cpython-312.pyc | Bin 0 -> 307 bytes .../param_functions.cpython-312.pyc | Bin 0 -> 35118 bytes .../__pycache__/params.cpython-312.pyc | Bin 0 -> 25063 bytes .../__pycache__/requests.cpython-312.pyc | Bin 0 -> 296 bytes .../__pycache__/responses.cpython-312.pyc | Bin 0 -> 2424 bytes .../__pycache__/routing.cpython-312.pyc | Bin 0 -> 82066 bytes .../__pycache__/staticfiles.cpython-312.pyc | Bin 0 -> 268 bytes .../__pycache__/templating.cpython-312.pyc | Bin 0 -> 270 bytes .../__pycache__/testclient.cpython-312.pyc | Bin 0 -> 265 bytes .../fastapi/__pycache__/types.cpython-312.pyc | Bin 0 -> 776 bytes .../fastapi/__pycache__/utils.cpython-312.pyc | Bin 0 -> 8394 bytes .../__pycache__/websockets.cpython-312.pyc | Bin 0 -> 345 bytes .venv/Lib/site-packages/fastapi/_compat.py | 659 ++ .../Lib/site-packages/fastapi/applications.py | 4585 +++++++++ .venv/Lib/site-packages/fastapi/background.py | 59 + .venv/Lib/site-packages/fastapi/cli.py | 13 + .../Lib/site-packages/fastapi/concurrency.py | 39 + .../site-packages/fastapi/datastructures.py | 204 + .../fastapi/dependencies/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 218 bytes .../__pycache__/models.cpython-312.pyc | Bin 0 -> 2761 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 38055 bytes .../fastapi/dependencies/models.py | 37 + .../fastapi/dependencies/utils.py | 972 ++ .venv/Lib/site-packages/fastapi/encoders.py | 343 + .../fastapi/exception_handlers.py | 34 + .venv/Lib/site-packages/fastapi/exceptions.py | 176 + .venv/Lib/site-packages/fastapi/logger.py | 3 + .../fastapi/middleware/__init__.py | 1 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 274 bytes .../__pycache__/cors.cpython-312.pyc | Bin 0 -> 279 bytes .../__pycache__/gzip.cpython-312.pyc | Bin 0 -> 279 bytes .../__pycache__/httpsredirect.cpython-312.pyc | Bin 0 -> 308 bytes .../__pycache__/trustedhost.cpython-312.pyc | Bin 0 -> 302 bytes .../__pycache__/wsgi.cpython-312.pyc | Bin 0 -> 279 bytes .../site-packages/fastapi/middleware/cors.py | 1 + .../site-packages/fastapi/middleware/gzip.py | 1 + .../fastapi/middleware/httpsredirect.py | 3 + .../fastapi/middleware/trustedhost.py | 3 + .../site-packages/fastapi/middleware/wsgi.py | 1 + .../site-packages/fastapi/openapi/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 213 bytes .../__pycache__/constants.cpython-312.pyc | Bin 0 -> 383 bytes .../openapi/__pycache__/docs.cpython-312.pyc | Bin 0 -> 10833 bytes .../__pycache__/models.cpython-312.pyc | Bin 0 -> 23021 bytes .../openapi/__pycache__/utils.cpython-312.pyc | Bin 0 -> 20340 bytes .../fastapi/openapi/constants.py | 3 + .../Lib/site-packages/fastapi/openapi/docs.py | 344 + .../site-packages/fastapi/openapi/models.py | 445 + .../site-packages/fastapi/openapi/utils.py | 548 ++ .../site-packages/fastapi/param_functions.py | 2360 +++++ .venv/Lib/site-packages/fastapi/params.py | 786 ++ .venv/Lib/site-packages/fastapi/py.typed | 0 .venv/Lib/site-packages/fastapi/requests.py | 2 + .venv/Lib/site-packages/fastapi/responses.py | 48 + .venv/Lib/site-packages/fastapi/routing.py | 4439 +++++++++ .../fastapi/security/__init__.py | 15 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 870 bytes .../__pycache__/api_key.cpython-312.pyc | Bin 0 -> 9721 bytes .../security/__pycache__/base.cpython-312.pyc | Bin 0 -> 532 bytes .../security/__pycache__/http.cpython-312.pyc | Bin 0 -> 13659 bytes .../__pycache__/oauth2.cpython-312.pyc | Bin 0 -> 18301 bytes .../open_id_connect_url.cpython-312.pyc | Bin 0 -> 3243 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 625 bytes .../site-packages/fastapi/security/api_key.py | 288 + .../site-packages/fastapi/security/base.py | 6 + .../site-packages/fastapi/security/http.py | 423 + .../site-packages/fastapi/security/oauth2.py | 638 ++ .../fastapi/security/open_id_connect_url.py | 84 + .../site-packages/fastapi/security/utils.py | 10 + .../Lib/site-packages/fastapi/staticfiles.py | 1 + .venv/Lib/site-packages/fastapi/templating.py | 1 + .venv/Lib/site-packages/fastapi/testclient.py | 1 + .venv/Lib/site-packages/fastapi/types.py | 10 + .venv/Lib/site-packages/fastapi/utils.py | 220 + .venv/Lib/site-packages/fastapi/websockets.py | 3 + .../greenlet-3.1.1.dist-info/AUTHORS | 51 + .../greenlet-3.1.1.dist-info/INSTALLER | 1 + .../greenlet-3.1.1.dist-info/LICENSE | 30 + .../greenlet-3.1.1.dist-info/LICENSE.PSF | 47 + .../greenlet-3.1.1.dist-info/METADATA | 103 + .../greenlet-3.1.1.dist-info/RECORD | 122 + .../greenlet-3.1.1.dist-info/WHEEL | 5 + .../greenlet-3.1.1.dist-info/top_level.txt | 1 + .venv/Lib/site-packages/greenlet/CObjects.cpp | 157 + .../Lib/site-packages/greenlet/PyGreenlet.cpp | 738 ++ .../Lib/site-packages/greenlet/PyGreenlet.hpp | 35 + .../greenlet/PyGreenletUnswitchable.cpp | 147 + .venv/Lib/site-packages/greenlet/PyModule.cpp | 292 + .../greenlet/TBrokenGreenlet.cpp | 45 + .../greenlet/TExceptionState.cpp | 62 + .../Lib/site-packages/greenlet/TGreenlet.cpp | 718 ++ .../Lib/site-packages/greenlet/TGreenlet.hpp | 813 ++ .../greenlet/TGreenletGlobals.cpp | 94 + .../site-packages/greenlet/TMainGreenlet.cpp | 153 + .../site-packages/greenlet/TPythonState.cpp | 393 + .../site-packages/greenlet/TStackState.cpp | 265 + .../site-packages/greenlet/TThreadState.hpp | 497 + .../greenlet/TThreadStateCreator.hpp | 102 + .../greenlet/TThreadStateDestroy.cpp | 258 + .../site-packages/greenlet/TUserGreenlet.cpp | 662 ++ .venv/Lib/site-packages/greenlet/__init__.py | 71 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1092 bytes .../greenlet/_greenlet.cp312-win_amd64.pyd | Bin 0 -> 219136 bytes .venv/Lib/site-packages/greenlet/greenlet.cpp | 320 + .venv/Lib/site-packages/greenlet/greenlet.h | 164 + .../greenlet/greenlet_allocator.hpp | 63 + .../greenlet/greenlet_compiler_compat.hpp | 98 + .../greenlet/greenlet_cpython_add_pending.hpp | 172 + .../greenlet/greenlet_cpython_compat.hpp | 142 + .../greenlet/greenlet_exceptions.hpp | 171 + .../greenlet/greenlet_internal.hpp | 107 + .../site-packages/greenlet/greenlet_refs.hpp | 1118 +++ .../greenlet/greenlet_slp_switch.hpp | 99 + .../greenlet/greenlet_thread_support.hpp | 31 + .../greenlet/platform/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 215 bytes .../platform/setup_switch_x64_masm.cmd | 2 + .../greenlet/platform/switch_aarch64_gcc.h | 124 + .../greenlet/platform/switch_alpha_unix.h | 30 + .../greenlet/platform/switch_amd64_unix.h | 87 + .../greenlet/platform/switch_arm32_gcc.h | 79 + .../greenlet/platform/switch_arm32_ios.h | 67 + .../greenlet/platform/switch_arm64_masm.asm | 53 + .../greenlet/platform/switch_arm64_masm.obj | Bin 0 -> 746 bytes .../greenlet/platform/switch_arm64_msvc.h | 17 + .../greenlet/platform/switch_csky_gcc.h | 48 + .../platform/switch_loongarch64_linux.h | 31 + .../greenlet/platform/switch_m68k_gcc.h | 38 + .../greenlet/platform/switch_mips_unix.h | 64 + .../greenlet/platform/switch_ppc64_aix.h | 103 + .../greenlet/platform/switch_ppc64_linux.h | 105 + .../greenlet/platform/switch_ppc_aix.h | 87 + .../greenlet/platform/switch_ppc_linux.h | 84 + .../greenlet/platform/switch_ppc_macosx.h | 82 + .../greenlet/platform/switch_ppc_unix.h | 82 + .../greenlet/platform/switch_riscv_unix.h | 36 + .../greenlet/platform/switch_s390_unix.h | 87 + .../greenlet/platform/switch_sh_gcc.h | 36 + .../greenlet/platform/switch_sparc_sun_gcc.h | 92 + .../greenlet/platform/switch_x32_unix.h | 63 + .../greenlet/platform/switch_x64_masm.asm | 111 + .../greenlet/platform/switch_x64_masm.obj | Bin 0 -> 1078 bytes .../greenlet/platform/switch_x64_msvc.h | 60 + .../greenlet/platform/switch_x86_msvc.h | 326 + .../greenlet/platform/switch_x86_unix.h | 105 + .../greenlet/slp_platformselect.h | 75 + .../site-packages/greenlet/tests/__init__.py | 240 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 9032 bytes ...fail_clearing_run_switches.cpython-312.pyc | Bin 0 -> 2100 bytes .../fail_cpp_exception.cpython-312.pyc | Bin 0 -> 1635 bytes ...nitialstub_already_started.cpython-312.pyc | Bin 0 -> 3503 bytes .../fail_slp_switch.cpython-312.pyc | Bin 0 -> 1328 bytes ...ail_switch_three_greenlets.cpython-312.pyc | Bin 0 -> 1744 bytes ...il_switch_three_greenlets2.cpython-312.pyc | Bin 0 -> 2598 bytes .../fail_switch_two_greenlets.cpython-312.pyc | Bin 0 -> 1715 bytes .../__pycache__/leakcheck.cpython-312.pyc | Bin 0 -> 11580 bytes .../test_contextvars.cpython-312.pyc | Bin 0 -> 15334 bytes .../__pycache__/test_cpp.cpython-312.pyc | Bin 0 -> 4112 bytes .../test_extension_interface.cpython-312.pyc | Bin 0 -> 7472 bytes .../tests/__pycache__/test_gc.cpython-312.pyc | Bin 0 -> 4950 bytes .../test_generator.cpython-312.pyc | Bin 0 -> 3088 bytes .../test_generator_nested.cpython-312.pyc | Bin 0 -> 7782 bytes .../__pycache__/test_greenlet.cpython-312.pyc | Bin 0 -> 74893 bytes .../test_greenlet_trash.cpython-312.pyc | Bin 0 -> 6795 bytes .../__pycache__/test_leaks.cpython-312.pyc | Bin 0 -> 19471 bytes .../test_stack_saved.cpython-312.pyc | Bin 0 -> 1367 bytes .../__pycache__/test_throw.cpython-312.pyc | Bin 0 -> 7375 bytes .../__pycache__/test_tracing.cpython-312.pyc | Bin 0 -> 13626 bytes .../__pycache__/test_version.cpython-312.pyc | Bin 0 -> 2574 bytes .../__pycache__/test_weakref.cpython-312.pyc | Bin 0 -> 2758 bytes .../greenlet/tests/_test_extension.c | 231 + .../tests/_test_extension.cp312-win_amd64.pyd | Bin 0 -> 14336 bytes .../_test_extension_cpp.cp312-win_amd64.pyd | Bin 0 -> 15872 bytes .../greenlet/tests/_test_extension_cpp.cpp | 226 + .../tests/fail_clearing_run_switches.py | 47 + .../greenlet/tests/fail_cpp_exception.py | 33 + .../tests/fail_initialstub_already_started.py | 78 + .../greenlet/tests/fail_slp_switch.py | 29 + .../tests/fail_switch_three_greenlets.py | 44 + .../tests/fail_switch_three_greenlets2.py | 55 + .../tests/fail_switch_two_greenlets.py | 41 + .../site-packages/greenlet/tests/leakcheck.py | 319 + .../greenlet/tests/test_contextvars.py | 310 + .../site-packages/greenlet/tests/test_cpp.py | 73 + .../tests/test_extension_interface.py | 115 + .../site-packages/greenlet/tests/test_gc.py | 86 + .../greenlet/tests/test_generator.py | 59 + .../greenlet/tests/test_generator_nested.py | 168 + .../greenlet/tests/test_greenlet.py | 1324 +++ .../greenlet/tests/test_greenlet_trash.py | 187 + .../greenlet/tests/test_leaks.py | 443 + .../greenlet/tests/test_stack_saved.py | 19 + .../greenlet/tests/test_throw.py | 128 + .../greenlet/tests/test_tracing.py | 291 + .../greenlet/tests/test_version.py | 41 + .../greenlet/tests/test_weakref.py | 35 + .../h11-0.14.0.dist-info/INSTALLER | 1 + .../h11-0.14.0.dist-info/LICENSE.txt | 22 + .../h11-0.14.0.dist-info/METADATA | 193 + .../site-packages/h11-0.14.0.dist-info/RECORD | 52 + .../site-packages/h11-0.14.0.dist-info/WHEEL | 5 + .../h11-0.14.0.dist-info/top_level.txt | 1 + .venv/Lib/site-packages/h11/__init__.py | 62 + .../h11/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1092 bytes .../h11/__pycache__/_abnf.cpython-312.pyc | Bin 0 -> 1798 bytes .../__pycache__/_connection.cpython-312.pyc | Bin 0 -> 22619 bytes .../h11/__pycache__/_events.cpython-312.pyc | Bin 0 -> 13298 bytes .../h11/__pycache__/_headers.cpython-312.pyc | Bin 0 -> 7865 bytes .../h11/__pycache__/_readers.cpython-312.pyc | Bin 0 -> 9427 bytes .../_receivebuffer.cpython-312.pyc | Bin 0 -> 4716 bytes .../h11/__pycache__/_state.cpython-312.pyc | Bin 0 -> 8551 bytes .../h11/__pycache__/_util.cpython-312.pyc | Bin 0 -> 4736 bytes .../h11/__pycache__/_version.cpython-312.pyc | Bin 0 -> 230 bytes .../h11/__pycache__/_writers.cpython-312.pyc | Bin 0 -> 6302 bytes .venv/Lib/site-packages/h11/_abnf.py | 132 + .venv/Lib/site-packages/h11/_connection.py | 633 ++ .venv/Lib/site-packages/h11/_events.py | 369 + .venv/Lib/site-packages/h11/_headers.py | 278 + .venv/Lib/site-packages/h11/_readers.py | 247 + .venv/Lib/site-packages/h11/_receivebuffer.py | 153 + .venv/Lib/site-packages/h11/_state.py | 367 + .venv/Lib/site-packages/h11/_util.py | 135 + .venv/Lib/site-packages/h11/_version.py | 16 + .venv/Lib/site-packages/h11/_writers.py | 145 + .venv/Lib/site-packages/h11/py.typed | 1 + .venv/Lib/site-packages/h11/tests/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 207 bytes .../tests/__pycache__/helpers.cpython-312.pyc | Bin 0 -> 4398 bytes .../test_against_stdlib_http.cpython-312.pyc | Bin 0 -> 6931 bytes .../test_connection.cpython-312.pyc | Bin 0 -> 58000 bytes .../__pycache__/test_events.cpython-312.pyc | Bin 0 -> 5462 bytes .../__pycache__/test_headers.cpython-312.pyc | Bin 0 -> 6976 bytes .../__pycache__/test_helpers.cpython-312.pyc | Bin 0 -> 1215 bytes .../tests/__pycache__/test_io.cpython-312.pyc | Bin 0 -> 19856 bytes .../test_receivebuffer.cpython-312.pyc | Bin 0 -> 3990 bytes .../__pycache__/test_state.cpython-312.pyc | Bin 0 -> 12552 bytes .../__pycache__/test_util.cpython-312.pyc | Bin 0 -> 6126 bytes .../site-packages/h11/tests/data/test-file | 1 + .venv/Lib/site-packages/h11/tests/helpers.py | 101 + .../h11/tests/test_against_stdlib_http.py | 115 + .../h11/tests/test_connection.py | 1122 +++ .../site-packages/h11/tests/test_events.py | 150 + .../site-packages/h11/tests/test_headers.py | 157 + .../site-packages/h11/tests/test_helpers.py | 32 + .venv/Lib/site-packages/h11/tests/test_io.py | 572 ++ .../h11/tests/test_receivebuffer.py | 135 + .../Lib/site-packages/h11/tests/test_state.py | 271 + .../Lib/site-packages/h11/tests/test_util.py | 112 + .../idna-3.10.dist-info/INSTALLER | 1 + .../idna-3.10.dist-info/LICENSE.md | 31 + .../idna-3.10.dist-info/METADATA | 250 + .../site-packages/idna-3.10.dist-info/RECORD | 22 + .../site-packages/idna-3.10.dist-info/WHEEL | 4 + .venv/Lib/site-packages/idna/__init__.py | 45 + .../idna/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 900 bytes .../idna/__pycache__/codec.cpython-312.pyc | Bin 0 -> 4990 bytes .../idna/__pycache__/compat.cpython-312.pyc | Bin 0 -> 904 bytes .../idna/__pycache__/core.cpython-312.pyc | Bin 0 -> 16135 bytes .../idna/__pycache__/idnadata.cpython-312.pyc | Bin 0 -> 99490 bytes .../__pycache__/intranges.cpython-312.pyc | Bin 0 -> 2647 bytes .../__pycache__/package_data.cpython-312.pyc | Bin 0 -> 231 bytes .../__pycache__/uts46data.cpython-312.pyc | Bin 0 -> 158860 bytes .venv/Lib/site-packages/idna/codec.py | 122 + .venv/Lib/site-packages/idna/compat.py | 15 + .venv/Lib/site-packages/idna/core.py | 437 + .venv/Lib/site-packages/idna/idnadata.py | 4243 ++++++++ .venv/Lib/site-packages/idna/intranges.py | 57 + .venv/Lib/site-packages/idna/package_data.py | 1 + .venv/Lib/site-packages/idna/py.typed | 0 .venv/Lib/site-packages/idna/uts46data.py | 8681 +++++++++++++++++ .../loguru-0.7.3.dist-info/INSTALLER | 1 + .../loguru-0.7.3.dist-info/METADATA | 462 + .../loguru-0.7.3.dist-info/RECORD | 45 + .../loguru-0.7.3.dist-info/REQUESTED | 0 .../loguru-0.7.3.dist-info/WHEEL | 4 + .venv/Lib/site-packages/loguru/__init__.py | 34 + .venv/Lib/site-packages/loguru/__init__.pyi | 368 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1028 bytes .../__pycache__/_asyncio_loop.cpython-312.pyc | Bin 0 -> 1313 bytes .../_better_exceptions.cpython-312.pyc | Bin 0 -> 24628 bytes .../__pycache__/_colorama.cpython-312.pyc | Bin 0 -> 2874 bytes .../__pycache__/_colorizer.cpython-312.pyc | Bin 0 -> 20065 bytes .../__pycache__/_contextvars.cpython-312.pyc | Bin 0 -> 652 bytes .../_ctime_functions.cpython-312.pyc | Bin 0 -> 3094 bytes .../__pycache__/_datetime.cpython-312.pyc | Bin 0 -> 12659 bytes .../__pycache__/_defaults.cpython-312.pyc | Bin 0 -> 3427 bytes .../_error_interceptor.cpython-312.pyc | Bin 0 -> 2105 bytes .../__pycache__/_file_sink.cpython-312.pyc | Bin 0 -> 21570 bytes .../__pycache__/_filters.cpython-312.pyc | Bin 0 -> 1020 bytes .../__pycache__/_get_frame.cpython-312.pyc | Bin 0 -> 989 bytes .../__pycache__/_handler.cpython-312.pyc | Bin 0 -> 14933 bytes .../_locks_machinery.cpython-312.pyc | Bin 0 -> 1855 bytes .../__pycache__/_logger.cpython-312.pyc | Bin 0 -> 103917 bytes .../__pycache__/_recattrs.cpython-312.pyc | Bin 0 -> 4579 bytes .../__pycache__/_simple_sinks.cpython-312.pyc | Bin 0 -> 7072 bytes .../_string_parsers.cpython-312.pyc | Bin 0 -> 8040 bytes .../Lib/site-packages/loguru/_asyncio_loop.py | 27 + .../loguru/_better_exceptions.py | 573 ++ .venv/Lib/site-packages/loguru/_colorama.py | 67 + .venv/Lib/site-packages/loguru/_colorizer.py | 481 + .../Lib/site-packages/loguru/_contextvars.py | 15 + .../site-packages/loguru/_ctime_functions.py | 57 + .venv/Lib/site-packages/loguru/_datetime.py | 160 + .venv/Lib/site-packages/loguru/_defaults.py | 75 + .../loguru/_error_interceptor.py | 34 + .venv/Lib/site-packages/loguru/_file_sink.py | 429 + .venv/Lib/site-packages/loguru/_filters.py | 24 + .venv/Lib/site-packages/loguru/_get_frame.py | 23 + .venv/Lib/site-packages/loguru/_handler.py | 341 + .../site-packages/loguru/_locks_machinery.py | 50 + .venv/Lib/site-packages/loguru/_logger.py | 2139 ++++ .venv/Lib/site-packages/loguru/_recattrs.py | 92 + .../Lib/site-packages/loguru/_simple_sinks.py | 129 + .../site-packages/loguru/_string_parsers.py | 185 + .venv/Lib/site-packages/loguru/py.typed | 0 .../pip-24.3.1.dist-info/AUTHORS.txt | 799 ++ .../pip-24.3.1.dist-info/INSTALLER | 1 + .../pip-24.3.1.dist-info/LICENSE.txt | 20 + .../pip-24.3.1.dist-info/METADATA | 90 + .../site-packages/pip-24.3.1.dist-info/RECORD | 853 ++ .../pip-24.3.1.dist-info/REQUESTED | 0 .../site-packages/pip-24.3.1.dist-info/WHEEL | 5 + .../pip-24.3.1.dist-info/entry_points.txt | 3 + .../pip-24.3.1.dist-info/top_level.txt | 1 + .venv/Lib/site-packages/pip/__init__.py | 13 + .venv/Lib/site-packages/pip/__main__.py | 24 + .venv/Lib/site-packages/pip/__pip-runner__.py | 50 + .../pip/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 712 bytes .../pip/__pycache__/__main__.cpython-312.pyc | Bin 0 -> 866 bytes .../__pip-runner__.cpython-312.pyc | Bin 0 -> 2230 bytes .../site-packages/pip/_internal/__init__.py | 18 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 812 bytes .../__pycache__/build_env.cpython-312.pyc | Bin 0 -> 14524 bytes .../__pycache__/cache.cpython-312.pyc | Bin 0 -> 12692 bytes .../__pycache__/configuration.cpython-312.pyc | Bin 0 -> 17657 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 36870 bytes .../__pycache__/main.cpython-312.pyc | Bin 0 -> 695 bytes .../__pycache__/pyproject.cpython-312.pyc | Bin 0 -> 5143 bytes .../self_outdated_check.cpython-312.pyc | Bin 0 -> 10233 bytes .../__pycache__/wheel_builder.cpython-312.pyc | Bin 0 -> 13640 bytes .../site-packages/pip/_internal/build_env.py | 319 + .../Lib/site-packages/pip/_internal/cache.py | 290 + .../pip/_internal/cli/__init__.py | 4 + .../cli/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 303 bytes .../autocompletion.cpython-312.pyc | Bin 0 -> 8631 bytes .../__pycache__/base_command.cpython-312.pyc | Bin 0 -> 10219 bytes .../__pycache__/cmdoptions.cpython-312.pyc | Bin 0 -> 30420 bytes .../command_context.cpython-312.pyc | Bin 0 -> 1799 bytes .../__pycache__/index_command.cpython-312.pyc | Bin 0 -> 7149 bytes .../cli/__pycache__/main.cpython-312.pyc | Bin 0 -> 2325 bytes .../__pycache__/main_parser.cpython-312.pyc | Bin 0 -> 4931 bytes .../cli/__pycache__/parser.cpython-312.pyc | Bin 0 -> 15065 bytes .../__pycache__/progress_bars.cpython-312.pyc | Bin 0 -> 3869 bytes .../__pycache__/req_command.cpython-312.pyc | Bin 0 -> 12266 bytes .../cli/__pycache__/spinners.cpython-312.pyc | Bin 0 -> 7858 bytes .../__pycache__/status_codes.cpython-312.pyc | Bin 0 -> 400 bytes .../pip/_internal/cli/autocompletion.py | 176 + .../pip/_internal/cli/base_command.py | 231 + .../pip/_internal/cli/cmdoptions.py | 1075 ++ .../pip/_internal/cli/command_context.py | 27 + .../pip/_internal/cli/index_command.py | 170 + .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4027 bytes .../__pycache__/cache.cpython-312.pyc | Bin 0 -> 9726 bytes .../__pycache__/check.cpython-312.pyc | Bin 0 -> 2617 bytes .../__pycache__/completion.cpython-312.pyc | Bin 0 -> 5218 bytes .../__pycache__/configuration.cpython-312.pyc | Bin 0 -> 13188 bytes .../__pycache__/debug.cpython-312.pyc | Bin 0 -> 10093 bytes .../__pycache__/download.cpython-312.pyc | Bin 0 -> 7528 bytes .../__pycache__/freeze.cpython-312.pyc | Bin 0 -> 4410 bytes .../commands/__pycache__/hash.cpython-312.pyc | Bin 0 -> 2993 bytes .../commands/__pycache__/help.cpython-312.pyc | Bin 0 -> 1698 bytes .../__pycache__/index.cpython-312.pyc | Bin 0 -> 6696 bytes .../__pycache__/inspect.cpython-312.pyc | Bin 0 -> 4005 bytes .../__pycache__/install.cpython-312.pyc | Bin 0 -> 29139 bytes .../commands/__pycache__/list.cpython-312.pyc | Bin 0 -> 15782 bytes .../__pycache__/search.cpython-312.pyc | Bin 0 -> 7543 bytes .../commands/__pycache__/show.cpython-312.pyc | Bin 0 -> 10502 bytes .../__pycache__/uninstall.cpython-312.pyc | Bin 0 -> 4734 bytes .../__pycache__/wheel.cpython-312.pyc | Bin 0 -> 8890 bytes .../pip/_internal/commands/cache.py | 225 + .../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 | 783 ++ .../pip/_internal/commands/list.py | 375 + .../pip/_internal/commands/search.py | 172 + .../pip/_internal/commands/show.py | 217 + .../pip/_internal/commands/uninstall.py | 114 + .../pip/_internal/commands/wheel.py | 182 + .../pip/_internal/configuration.py | 383 + .../pip/_internal/distributions/__init__.py | 21 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 966 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 2918 bytes .../__pycache__/installed.cpython-312.pyc | Bin 0 -> 1725 bytes .../__pycache__/sdist.cpython-312.pyc | Bin 0 -> 8452 bytes .../__pycache__/wheel.cpython-312.pyc | Bin 0 -> 2306 bytes .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 257 bytes .../__pycache__/collector.cpython-312.pyc | Bin 0 -> 21642 bytes .../package_finder.cpython-312.pyc | Bin 0 -> 40673 bytes .../index/__pycache__/sources.cpython-312.pyc | Bin 0 -> 12549 bytes .../pip/_internal/index/collector.py | 494 + .../pip/_internal/index/package_finder.py | 1020 ++ .../pip/_internal/index/sources.py | 284 + .../pip/_internal/locations/__init__.py | 456 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 16465 bytes .../__pycache__/_distutils.cpython-312.pyc | Bin 0 -> 6816 bytes .../__pycache__/_sysconfig.cpython-312.pyc | Bin 0 -> 8053 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 3806 bytes .../pip/_internal/locations/_distutils.py | 172 + .../pip/_internal/locations/_sysconfig.py | 214 + .../pip/_internal/locations/base.py | 81 + .venv/Lib/site-packages/pip/_internal/main.py | 12 + .../pip/_internal/metadata/__init__.py | 128 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5894 bytes .../__pycache__/_json.cpython-312.pyc | Bin 0 -> 2951 bytes .../metadata/__pycache__/base.cpython-312.pyc | Bin 0 -> 35223 bytes .../__pycache__/pkg_resources.cpython-312.pyc | Bin 0 -> 16109 bytes .../pip/_internal/metadata/_json.py | 84 + .../pip/_internal/metadata/base.py | 688 ++ .../_internal/metadata/importlib/__init__.py | 6 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 383 bytes .../__pycache__/_compat.cpython-312.pyc | Bin 0 -> 4516 bytes .../__pycache__/_dists.cpython-312.pyc | Bin 0 -> 12590 bytes .../__pycache__/_envs.cpython-312.pyc | Bin 0 -> 11104 bytes .../_internal/metadata/importlib/_compat.py | 85 + .../_internal/metadata/importlib/_dists.py | 221 + .../pip/_internal/metadata/importlib/_envs.py | 189 + .../pip/_internal/metadata/pkg_resources.py | 301 + .../pip/_internal/models/__init__.py | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 291 bytes .../__pycache__/candidate.cpython-312.pyc | Bin 0 -> 1629 bytes .../__pycache__/direct_url.cpython-312.pyc | Bin 0 -> 10869 bytes .../format_control.cpython-312.pyc | Bin 0 -> 4248 bytes .../models/__pycache__/index.cpython-312.pyc | Bin 0 -> 1719 bytes .../installation_report.cpython-312.pyc | Bin 0 -> 2302 bytes .../models/__pycache__/link.cpython-312.pyc | Bin 0 -> 26642 bytes .../models/__pycache__/scheme.cpython-312.pyc | Bin 0 -> 1048 bytes .../__pycache__/search_scope.cpython-312.pyc | Bin 0 -> 5012 bytes .../selection_prefs.cpython-312.pyc | Bin 0 -> 1876 bytes .../__pycache__/target_python.cpython-312.pyc | Bin 0 -> 4978 bytes .../models/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 6577 bytes .../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 | 590 ++ .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 279 bytes .../network/__pycache__/auth.cpython-312.pyc | Bin 0 -> 22124 bytes .../network/__pycache__/cache.cpython-312.pyc | Bin 0 -> 6476 bytes .../__pycache__/download.cpython-312.pyc | Bin 0 -> 8504 bytes .../__pycache__/lazy_wheel.cpython-312.pyc | Bin 0 -> 11632 bytes .../__pycache__/session.cpython-312.pyc | Bin 0 -> 18899 bytes .../network/__pycache__/utils.cpython-312.pyc | Bin 0 -> 2280 bytes .../__pycache__/xmlrpc.cpython-312.pyc | Bin 0 -> 2974 bytes .../pip/_internal/network/auth.py | 566 ++ .../pip/_internal/network/cache.py | 106 + .../pip/_internal/network/download.py | 187 + .../pip/_internal/network/lazy_wheel.py | 210 + .../pip/_internal/network/session.py | 522 + .../pip/_internal/network/utils.py | 98 + .../pip/_internal/network/xmlrpc.py | 62 + .../pip/_internal/operations/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 222 bytes .../__pycache__/check.cpython-312.pyc | Bin 0 -> 7129 bytes .../__pycache__/freeze.cpython-312.pyc | Bin 0 -> 10153 bytes .../__pycache__/prepare.cpython-312.pyc | Bin 0 -> 25797 bytes .../_internal/operations/build/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 228 bytes .../__pycache__/build_tracker.cpython-312.pyc | Bin 0 -> 7692 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 1882 bytes .../metadata_editable.cpython-312.pyc | Bin 0 -> 1916 bytes .../metadata_legacy.cpython-312.pyc | Bin 0 -> 3036 bytes .../build/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 1702 bytes .../wheel_editable.cpython-312.pyc | Bin 0 -> 2041 bytes .../__pycache__/wheel_legacy.cpython-312.pyc | Bin 0 -> 3871 bytes .../operations/build/build_tracker.py | 138 + .../_internal/operations/build/metadata.py | 39 + .../operations/build/metadata_editable.py | 41 + .../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 | 258 + .../_internal/operations/install/__init__.py | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 291 bytes .../editable_legacy.cpython-312.pyc | Bin 0 -> 1823 bytes .../install/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 34128 bytes .../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 + .../req/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3470 bytes .../__pycache__/constructors.cpython-312.pyc | Bin 0 -> 21280 bytes .../req/__pycache__/req_file.cpython-312.pyc | Bin 0 -> 22148 bytes .../__pycache__/req_install.cpython-312.pyc | Bin 0 -> 38500 bytes .../req/__pycache__/req_set.cpython-312.pyc | Bin 0 -> 5508 bytes .../__pycache__/req_uninstall.cpython-312.pyc | Bin 0 -> 32119 bytes .../pip/_internal/req/constructors.py | 560 ++ .../pip/_internal/req/req_file.py | 574 ++ .../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 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 222 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 1210 bytes .../pip/_internal/resolution/base.py | 20 + .../_internal/resolution/legacy/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 229 bytes .../__pycache__/resolver.cpython-312.pyc | Bin 0 -> 22604 bytes .../_internal/resolution/legacy/resolver.py | 597 ++ .../resolution/resolvelib/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 233 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 8174 bytes .../__pycache__/candidates.cpython-312.pyc | Bin 0 -> 29433 bytes .../__pycache__/factory.cpython-312.pyc | Bin 0 -> 32544 bytes .../found_candidates.cpython-312.pyc | Bin 0 -> 6818 bytes .../__pycache__/provider.cpython-312.pyc | Bin 0 -> 10548 bytes .../__pycache__/reporter.cpython-312.pyc | Bin 0 -> 5065 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 15381 bytes .../__pycache__/resolver.cpython-312.pyc | Bin 0 -> 12339 bytes .../_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 | 244 + .../pip/_internal/utils/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 217 bytes .../__pycache__/_jaraco_text.cpython-312.pyc | Bin 0 -> 4552 bytes .../utils/__pycache__/_log.cpython-312.pyc | Bin 0 -> 1888 bytes .../utils/__pycache__/appdirs.cpython-312.pyc | Bin 0 -> 2432 bytes .../utils/__pycache__/compat.cpython-312.pyc | Bin 0 -> 2929 bytes .../compatibility_tags.cpython-312.pyc | Bin 0 -> 6372 bytes .../__pycache__/datetime.cpython-312.pyc | Bin 0 -> 706 bytes .../__pycache__/deprecation.cpython-312.pyc | Bin 0 -> 4213 bytes .../direct_url_helpers.cpython-312.pyc | Bin 0 -> 3558 bytes .../__pycache__/egg_link.cpython-312.pyc | Bin 0 -> 3228 bytes .../__pycache__/encoding.cpython-312.pyc | Bin 0 -> 2170 bytes .../__pycache__/entrypoints.cpython-312.pyc | Bin 0 -> 4015 bytes .../__pycache__/filesystem.cpython-312.pyc | Bin 0 -> 7351 bytes .../__pycache__/filetypes.cpython-312.pyc | Bin 0 -> 1186 bytes .../utils/__pycache__/glibc.cpython-312.pyc | Bin 0 -> 2441 bytes .../utils/__pycache__/hashes.cpython-312.pyc | Bin 0 -> 7625 bytes .../utils/__pycache__/logging.cpython-312.pyc | Bin 0 -> 13580 bytes .../utils/__pycache__/misc.cpython-312.pyc | Bin 0 -> 33473 bytes .../__pycache__/packaging.cpython-312.pyc | Bin 0 -> 2605 bytes .../utils/__pycache__/retry.cpython-312.pyc | Bin 0 -> 2130 bytes .../setuptools_build.cpython-312.pyc | Bin 0 -> 4572 bytes .../__pycache__/subprocess.cpython-312.pyc | Bin 0 -> 8661 bytes .../__pycache__/temp_dir.cpython-312.pyc | Bin 0 -> 12046 bytes .../__pycache__/unpacking.cpython-312.pyc | Bin 0 -> 13520 bytes .../utils/__pycache__/urls.cpython-312.pyc | Bin 0 -> 2099 bytes .../__pycache__/virtualenv.cpython-312.pyc | Bin 0 -> 4488 bytes .../utils/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 5925 bytes .../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/encoding.py | 36 + .../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 | 347 + .../site-packages/pip/_internal/utils/misc.py | 772 ++ .../pip/_internal/utils/packaging.py | 57 + .../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 + .../vcs/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 556 bytes .../vcs/__pycache__/bazaar.cpython-312.pyc | Bin 0 -> 5077 bytes .../vcs/__pycache__/git.cpython-312.pyc | Bin 0 -> 19042 bytes .../vcs/__pycache__/mercurial.cpython-312.pyc | Bin 0 -> 7630 bytes .../__pycache__/subversion.cpython-312.pyc | Bin 0 -> 12549 bytes .../versioncontrol.cpython-312.pyc | Bin 0 -> 29022 bytes .../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 + .../Lib/site-packages/pip/_vendor/__init__.py | 116 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4575 bytes .../typing_extensions.cpython-312.pyc | Bin 0 -> 139477 bytes .../pip/_vendor/cachecontrol/__init__.py | 28 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 928 bytes .../__pycache__/_cmd.cpython-312.pyc | Bin 0 -> 2672 bytes .../__pycache__/adapter.cpython-312.pyc | Bin 0 -> 6490 bytes .../__pycache__/cache.cpython-312.pyc | Bin 0 -> 3813 bytes .../__pycache__/controller.cpython-312.pyc | Bin 0 -> 16250 bytes .../__pycache__/filewrapper.cpython-312.pyc | Bin 0 -> 4373 bytes .../__pycache__/heuristics.cpython-312.pyc | Bin 0 -> 6720 bytes .../__pycache__/serialize.cpython-312.pyc | Bin 0 -> 5287 bytes .../__pycache__/wrapper.cpython-312.pyc | Bin 0 -> 1700 bytes .../pip/_vendor/cachecontrol/_cmd.py | 70 + .../pip/_vendor/cachecontrol/adapter.py | 161 + .../pip/_vendor/cachecontrol/cache.py | 74 + .../_vendor/cachecontrol/caches/__init__.py | 8 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 461 bytes .../__pycache__/file_cache.cpython-312.pyc | Bin 0 -> 7789 bytes .../__pycache__/redis_cache.cpython-312.pyc | Bin 0 -> 2759 bytes .../_vendor/cachecontrol/caches/file_cache.py | 182 + .../cachecontrol/caches/redis_cache.py | 48 + .../pip/_vendor/cachecontrol/controller.py | 499 + .../pip/_vendor/cachecontrol/filewrapper.py | 119 + .../pip/_vendor/cachecontrol/heuristics.py | 154 + .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 344 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 671 bytes .../certifi/__pycache__/core.cpython-312.pyc | Bin 0 -> 3237 bytes .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1295 bytes .../__pycache__/compat.cpython-312.pyc | Bin 0 -> 45552 bytes .../__pycache__/database.cpython-312.pyc | Bin 0 -> 65607 bytes .../distlib/__pycache__/index.cpython-312.pyc | Bin 0 -> 24342 bytes .../__pycache__/locators.cpython-312.pyc | Bin 0 -> 59887 bytes .../__pycache__/manifest.cpython-312.pyc | Bin 0 -> 15102 bytes .../__pycache__/markers.cpython-312.pyc | Bin 0 -> 7680 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 41586 bytes .../__pycache__/resources.cpython-312.pyc | Bin 0 -> 17338 bytes .../__pycache__/scripts.cpython-312.pyc | Bin 0 -> 19779 bytes .../distlib/__pycache__/util.cpython-312.pyc | Bin 0 -> 88061 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 30370 bytes .../distlib/__pycache__/wheel.cpython-312.pyc | Bin 0 -> 52571 bytes .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 986 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 318 bytes .../distro/__pycache__/distro.cpython-312.pyc | Bin 0 -> 53818 bytes .../pip/_vendor/distro/distro.py | 1403 +++ .../site-packages/pip/_vendor/distro/py.typed | 0 .../pip/_vendor/idna/__init__.py | 44 + .../idna/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 907 bytes .../idna/__pycache__/codec.cpython-312.pyc | Bin 0 -> 5002 bytes .../idna/__pycache__/compat.cpython-312.pyc | Bin 0 -> 913 bytes .../idna/__pycache__/core.cpython-312.pyc | Bin 0 -> 15817 bytes .../idna/__pycache__/idnadata.cpython-312.pyc | Bin 0 -> 99502 bytes .../__pycache__/intranges.cpython-312.pyc | Bin 0 -> 2659 bytes .../__pycache__/package_data.cpython-312.pyc | Bin 0 -> 242 bytes .../__pycache__/uts46data.cpython-312.pyc | Bin 0 -> 158874 bytes .../site-packages/pip/_vendor/idna/codec.py | 118 + .../site-packages/pip/_vendor/idna/compat.py | 13 + .../site-packages/pip/_vendor/idna/core.py | 395 + .../pip/_vendor/idna/idnadata.py | 4245 ++++++++ .../pip/_vendor/idna/intranges.py | 54 + .../pip/_vendor/idna/package_data.py | 2 + .../site-packages/pip/_vendor/idna/py.typed | 0 .../pip/_vendor/idna/uts46data.py | 8598 ++++++++++++++++ .../pip/_vendor/msgpack/__init__.py | 55 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1767 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 2051 bytes .../msgpack/__pycache__/ext.cpython-312.pyc | Bin 0 -> 8196 bytes .../__pycache__/fallback.cpython-312.pyc | Bin 0 -> 42069 bytes .../pip/_vendor/msgpack/exceptions.py | 48 + .../site-packages/pip/_vendor/msgpack/ext.py | 168 + .../pip/_vendor/msgpack/fallback.py | 951 ++ .../pip/_vendor/packaging/__init__.py | 15 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 584 bytes .../__pycache__/_elffile.cpython-312.pyc | Bin 0 -> 4993 bytes .../__pycache__/_manylinux.cpython-312.pyc | Bin 0 -> 9711 bytes .../__pycache__/_musllinux.cpython-312.pyc | Bin 0 -> 4580 bytes .../__pycache__/_parser.cpython-312.pyc | Bin 0 -> 14011 bytes .../__pycache__/_structures.cpython-312.pyc | Bin 0 -> 3267 bytes .../__pycache__/_tokenizer.cpython-312.pyc | Bin 0 -> 7941 bytes .../__pycache__/markers.cpython-312.pyc | Bin 0 -> 11037 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 24979 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 4436 bytes .../__pycache__/specifiers.cpython-312.pyc | Bin 0 -> 38765 bytes .../__pycache__/tags.cpython-312.pyc | Bin 0 -> 23245 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 7367 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 19533 bytes .../pip/_vendor/packaging/_elffile.py | 110 + .../pip/_vendor/packaging/_manylinux.py | 262 + .../pip/_vendor/packaging/_musllinux.py | 85 + .../pip/_vendor/packaging/_parser.py | 354 + .../pip/_vendor/packaging/_structures.py | 61 + .../pip/_vendor/packaging/_tokenizer.py | 194 + .../pip/_vendor/packaging/markers.py | 325 + .../pip/_vendor/packaging/metadata.py | 804 ++ .../pip/_vendor/packaging/py.typed | 0 .../pip/_vendor/packaging/requirements.py | 91 + .../pip/_vendor/packaging/specifiers.py | 1009 ++ .../pip/_vendor/packaging/tags.py | 627 ++ .../pip/_vendor/packaging/utils.py | 174 + .../pip/_vendor/packaging/version.py | 563 ++ .../pip/_vendor/pkg_resources/__init__.py | 3676 +++++++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 161287 bytes .../pip/_vendor/platformdirs/__init__.py | 627 ++ .../pip/_vendor/platformdirs/__main__.py | 55 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 19855 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 1974 bytes .../__pycache__/android.cpython-312.pyc | Bin 0 -> 10723 bytes .../__pycache__/api.cpython-312.pyc | Bin 0 -> 12937 bytes .../__pycache__/macos.cpython-312.pyc | Bin 0 -> 8033 bytes .../__pycache__/unix.cpython-312.pyc | Bin 0 -> 15063 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 623 bytes .../__pycache__/windows.cpython-312.pyc | Bin 0 -> 13700 bytes .../pip/_vendor/platformdirs/android.py | 249 + .../pip/_vendor/platformdirs/api.py | 292 + .../pip/_vendor/platformdirs/macos.py | 130 + .../pip/_vendor/platformdirs/py.typed | 0 .../pip/_vendor/platformdirs/unix.py | 275 + .../pip/_vendor/platformdirs/version.py | 16 + .../pip/_vendor/platformdirs/windows.py | 272 + .../pip/_vendor/pygments/__init__.py | 82 + .../pip/_vendor/pygments/__main__.py | 17 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3515 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 761 bytes .../__pycache__/cmdline.cpython-312.pyc | Bin 0 -> 26611 bytes .../__pycache__/console.cpython-312.pyc | Bin 0 -> 2655 bytes .../__pycache__/filter.cpython-312.pyc | Bin 0 -> 3248 bytes .../__pycache__/formatter.cpython-312.pyc | Bin 0 -> 4747 bytes .../__pycache__/lexer.cpython-312.pyc | Bin 0 -> 38388 bytes .../__pycache__/modeline.cpython-312.pyc | Bin 0 -> 1586 bytes .../__pycache__/plugin.cpython-312.pyc | Bin 0 -> 2635 bytes .../__pycache__/regexopt.cpython-312.pyc | Bin 0 -> 4104 bytes .../__pycache__/scanner.cpython-312.pyc | Bin 0 -> 4783 bytes .../__pycache__/sphinxext.cpython-312.pyc | Bin 0 -> 12125 bytes .../__pycache__/style.cpython-312.pyc | Bin 0 -> 6720 bytes .../__pycache__/token.cpython-312.pyc | Bin 0 -> 8216 bytes .../__pycache__/unistring.cpython-312.pyc | Bin 0 -> 32999 bytes .../pygments/__pycache__/util.cpython-312.pyc | Bin 0 -> 14096 bytes .../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 ++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 37938 bytes .../pip/_vendor/pygments/formatter.py | 129 + .../_vendor/pygments/formatters/__init__.py | 157 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 6929 bytes .../__pycache__/_mapping.cpython-312.pyc | Bin 0 -> 4242 bytes .../__pycache__/bbcode.cpython-312.pyc | Bin 0 -> 4249 bytes .../__pycache__/groff.cpython-312.pyc | Bin 0 -> 7320 bytes .../__pycache__/html.cpython-312.pyc | Bin 0 -> 41053 bytes .../__pycache__/img.cpython-312.pyc | Bin 0 -> 28575 bytes .../__pycache__/irc.cpython-312.pyc | Bin 0 -> 6082 bytes .../__pycache__/latex.cpython-312.pyc | Bin 0 -> 20152 bytes .../__pycache__/other.cpython-312.pyc | Bin 0 -> 6904 bytes .../__pycache__/pangomarkup.cpython-312.pyc | Bin 0 -> 2985 bytes .../__pycache__/rtf.cpython-312.pyc | Bin 0 -> 13800 bytes .../__pycache__/svg.cpython-312.pyc | Bin 0 -> 9166 bytes .../__pycache__/terminal.cpython-312.pyc | Bin 0 -> 5846 bytes .../__pycache__/terminal256.cpython-312.pyc | Bin 0 -> 15145 bytes .../_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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 14648 bytes .../__pycache__/_mapping.cpython-312.pyc | Bin 0 -> 68290 bytes .../lexers/__pycache__/python.cpython-312.pyc | Bin 0 -> 42994 bytes .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2691 bytes .../__pycache__/_mapping.cpython-312.pyc | Bin 0 -> 3675 bytes .../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 | 23 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 640 bytes .../__pycache__/_compat.cpython-312.pyc | Bin 0 -> 401 bytes .../__pycache__/_impl.cpython-312.pyc | Bin 0 -> 14720 bytes .../pip/_vendor/pyproject_hooks/_compat.py | 8 + .../pip/_vendor/pyproject_hooks/_impl.py | 330 + .../pyproject_hooks/_in_process/__init__.py | 18 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1107 bytes .../__pycache__/_in_process.cpython-312.pyc | Bin 0 -> 14380 bytes .../_in_process/_in_process.py | 353 + .../pip/_vendor/requests/__init__.py | 179 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5280 bytes .../__pycache__/__version__.cpython-312.pyc | Bin 0 -> 611 bytes .../_internal_utils.cpython-312.pyc | Bin 0 -> 2051 bytes .../__pycache__/adapters.cpython-312.pyc | Bin 0 -> 28458 bytes .../requests/__pycache__/api.cpython-312.pyc | Bin 0 -> 7218 bytes .../requests/__pycache__/auth.cpython-312.pyc | Bin 0 -> 13948 bytes .../__pycache__/certs.cpython-312.pyc | Bin 0 -> 949 bytes .../__pycache__/compat.cpython-312.pyc | Bin 0 -> 1704 bytes .../__pycache__/cookies.cpython-312.pyc | Bin 0 -> 25225 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 7625 bytes .../requests/__pycache__/help.cpython-312.pyc | Bin 0 -> 4255 bytes .../__pycache__/hooks.cpython-312.pyc | Bin 0 -> 1078 bytes .../__pycache__/models.cpython-312.pyc | Bin 0 -> 35455 bytes .../__pycache__/packages.cpython-312.pyc | Bin 0 -> 1293 bytes .../__pycache__/sessions.cpython-312.pyc | Bin 0 -> 27873 bytes .../__pycache__/status_codes.cpython-312.pyc | Bin 0 -> 6050 bytes .../__pycache__/structures.cpython-312.pyc | Bin 0 -> 5650 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 36393 bytes .../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 | 24 + .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 661 bytes .../__pycache__/providers.cpython-312.pyc | Bin 0 -> 6878 bytes .../__pycache__/reporters.cpython-312.pyc | Bin 0 -> 2681 bytes .../__pycache__/resolvers.cpython-312.pyc | Bin 0 -> 25907 bytes .../__pycache__/structs.cpython-312.pyc | Bin 0 -> 10527 bytes .../pip/_vendor/resolvelib/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 227 bytes .../collections_abc.cpython-312.pyc | Bin 0 -> 447 bytes .../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 + .../rich/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 7042 bytes .../rich/__pycache__/__main__.cpython-312.pyc | Bin 0 -> 10319 bytes .../__pycache__/_cell_widths.cpython-312.pyc | Bin 0 -> 7899 bytes .../__pycache__/_emoji_codes.cpython-312.pyc | Bin 0 -> 206003 bytes .../_emoji_replace.cpython-312.pyc | Bin 0 -> 1756 bytes .../_export_format.cpython-312.pyc | Bin 0 -> 2376 bytes .../__pycache__/_extension.cpython-312.pyc | Bin 0 -> 564 bytes .../rich/__pycache__/_fileno.cpython-312.pyc | Bin 0 -> 882 bytes .../rich/__pycache__/_inspect.cpython-312.pyc | Bin 0 -> 12100 bytes .../__pycache__/_log_render.cpython-312.pyc | Bin 0 -> 4174 bytes .../rich/__pycache__/_loop.cpython-312.pyc | Bin 0 -> 1897 bytes .../__pycache__/_null_file.cpython-312.pyc | Bin 0 -> 3647 bytes .../__pycache__/_palettes.cpython-312.pyc | Bin 0 -> 5187 bytes .../rich/__pycache__/_pick.cpython-312.pyc | Bin 0 -> 748 bytes .../rich/__pycache__/_ratio.cpython-312.pyc | Bin 0 -> 6597 bytes .../__pycache__/_spinners.cpython-312.pyc | Bin 0 -> 13206 bytes .../rich/__pycache__/_stack.cpython-312.pyc | Bin 0 -> 992 bytes .../rich/__pycache__/_timer.cpython-312.pyc | Bin 0 -> 892 bytes .../_win32_console.cpython-312.pyc | Bin 0 -> 29003 bytes .../rich/__pycache__/_windows.cpython-312.pyc | Bin 0 -> 2517 bytes .../_windows_renderer.cpython-312.pyc | Bin 0 -> 3590 bytes .../rich/__pycache__/_wrap.cpython-312.pyc | Bin 0 -> 3353 bytes .../rich/__pycache__/abc.cpython-312.pyc | Bin 0 -> 1635 bytes .../rich/__pycache__/align.cpython-312.pyc | Bin 0 -> 12314 bytes .../rich/__pycache__/ansi.cpython-312.pyc | Bin 0 -> 9093 bytes .../rich/__pycache__/bar.cpython-312.pyc | Bin 0 -> 4299 bytes .../rich/__pycache__/box.cpython-312.pyc | Bin 0 -> 11865 bytes .../rich/__pycache__/cells.cpython-312.pyc | Bin 0 -> 5837 bytes .../rich/__pycache__/color.cpython-312.pyc | Bin 0 -> 26596 bytes .../__pycache__/color_triplet.cpython-312.pyc | Bin 0 -> 1728 bytes .../rich/__pycache__/columns.cpython-312.pyc | Bin 0 -> 8611 bytes .../rich/__pycache__/console.cpython-312.pyc | Bin 0 -> 113463 bytes .../__pycache__/constrain.cpython-312.pyc | Bin 0 -> 2285 bytes .../__pycache__/containers.cpython-312.pyc | Bin 0 -> 9237 bytes .../rich/__pycache__/control.cpython-312.pyc | Bin 0 -> 10968 bytes .../default_styles.cpython-312.pyc | Bin 0 -> 10393 bytes .../rich/__pycache__/diagnose.cpython-312.pyc | Bin 0 -> 1515 bytes .../rich/__pycache__/emoji.cpython-312.pyc | Bin 0 -> 4239 bytes .../rich/__pycache__/errors.cpython-312.pyc | Bin 0 -> 1872 bytes .../__pycache__/file_proxy.cpython-312.pyc | Bin 0 -> 3598 bytes .../rich/__pycache__/filesize.cpython-312.pyc | Bin 0 -> 3099 bytes .../__pycache__/highlighter.cpython-312.pyc | Bin 0 -> 9914 bytes .../rich/__pycache__/json.cpython-312.pyc | Bin 0 -> 6062 bytes .../rich/__pycache__/jupyter.cpython-312.pyc | Bin 0 -> 5235 bytes .../rich/__pycache__/layout.cpython-312.pyc | Bin 0 -> 20185 bytes .../rich/__pycache__/live.cpython-312.pyc | Bin 0 -> 19036 bytes .../__pycache__/live_render.cpython-312.pyc | Bin 0 -> 4916 bytes .../rich/__pycache__/logging.cpython-312.pyc | Bin 0 -> 13581 bytes .../rich/__pycache__/markup.cpython-312.pyc | Bin 0 -> 9594 bytes .../rich/__pycache__/measure.cpython-312.pyc | Bin 0 -> 6405 bytes .../rich/__pycache__/padding.cpython-312.pyc | Bin 0 -> 7151 bytes .../rich/__pycache__/pager.cpython-312.pyc | Bin 0 -> 1838 bytes .../rich/__pycache__/palette.cpython-312.pyc | Bin 0 -> 5324 bytes .../rich/__pycache__/panel.cpython-312.pyc | Bin 0 -> 12210 bytes .../rich/__pycache__/pretty.cpython-312.pyc | Bin 0 -> 40174 bytes .../rich/__pycache__/progress.cpython-312.pyc | Bin 0 -> 74962 bytes .../__pycache__/progress_bar.cpython-312.pyc | Bin 0 -> 10404 bytes .../rich/__pycache__/prompt.cpython-312.pyc | Bin 0 -> 14814 bytes .../rich/__pycache__/protocol.cpython-312.pyc | Bin 0 -> 1819 bytes .../rich/__pycache__/region.cpython-312.pyc | Bin 0 -> 594 bytes .../rich/__pycache__/repr.cpython-312.pyc | Bin 0 -> 6640 bytes .../rich/__pycache__/rule.cpython-312.pyc | Bin 0 -> 6595 bytes .../rich/__pycache__/scope.cpython-312.pyc | Bin 0 -> 3852 bytes .../rich/__pycache__/screen.cpython-312.pyc | Bin 0 -> 2506 bytes .../rich/__pycache__/segment.cpython-312.pyc | Bin 0 -> 28142 bytes .../rich/__pycache__/spinner.cpython-312.pyc | Bin 0 -> 6091 bytes .../rich/__pycache__/status.cpython-312.pyc | Bin 0 -> 6088 bytes .../rich/__pycache__/style.cpython-312.pyc | Bin 0 -> 33527 bytes .../rich/__pycache__/styled.cpython-312.pyc | Bin 0 -> 2166 bytes .../rich/__pycache__/syntax.cpython-312.pyc | Bin 0 -> 39975 bytes .../rich/__pycache__/table.cpython-312.pyc | Bin 0 -> 43566 bytes .../terminal_theme.cpython-312.pyc | Bin 0 -> 3375 bytes .../rich/__pycache__/text.cpython-312.pyc | Bin 0 -> 60876 bytes .../rich/__pycache__/theme.cpython-312.pyc | Bin 0 -> 6362 bytes .../rich/__pycache__/themes.cpython-312.pyc | Bin 0 -> 341 bytes .../__pycache__/traceback.cpython-312.pyc | Bin 0 -> 31538 bytes .../rich/__pycache__/tree.cpython-312.pyc | Bin 0 -> 11463 bytes .../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 | 270 + .../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 | 662 ++ .../pip/_vendor/rich/_windows.py | 71 + .../pip/_vendor/rich/_windows_renderer.py | 56 + .../site-packages/pip/_vendor/rich/_wrap.py | 93 + .../Lib/site-packages/pip/_vendor/rich/abc.py | 33 + .../site-packages/pip/_vendor/rich/align.py | 311 + .../site-packages/pip/_vendor/rich/ansi.py | 240 + .../Lib/site-packages/pip/_vendor/rich/bar.py | 93 + .../Lib/site-packages/pip/_vendor/rich/box.py | 480 + .../site-packages/pip/_vendor/rich/cells.py | 167 + .../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 | 2633 +++++ .../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 | 190 + .../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 | 89 + .../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 | 289 + .../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 | 312 + .../site-packages/pip/_vendor/rich/pretty.py | 995 ++ .../pip/_vendor/rich/progress.py | 1699 ++++ .../pip/_vendor/rich/progress_bar.py | 223 + .../site-packages/pip/_vendor/rich/prompt.py | 375 + .../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 | 738 ++ .../site-packages/pip/_vendor/rich/spinner.py | 137 + .../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 | 958 ++ .../site-packages/pip/_vendor/rich/table.py | 1000 ++ .../pip/_vendor/rich/terminal_theme.py | 153 + .../site-packages/pip/_vendor/rich/text.py | 1357 +++ .../site-packages/pip/_vendor/rich/theme.py | 115 + .../site-packages/pip/_vendor/rich/themes.py | 5 + .../pip/_vendor/rich/traceback.py | 753 ++ .../site-packages/pip/_vendor/rich/tree.py | 249 + .../pip/_vendor/tomli/__init__.py | 11 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 411 bytes .../tomli/__pycache__/_parser.cpython-312.pyc | Bin 0 -> 26926 bytes .../tomli/__pycache__/_re.cpython-312.pyc | Bin 0 -> 3935 bytes .../tomli/__pycache__/_types.cpython-312.pyc | Bin 0 -> 393 bytes .../pip/_vendor/tomli/_parser.py | 691 ++ .../site-packages/pip/_vendor/tomli/_re.py | 107 + .../site-packages/pip/_vendor/tomli/_types.py | 10 + .../site-packages/pip/_vendor/tomli/py.typed | 1 + .../pip/_vendor/truststore/__init__.py | 36 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1371 bytes .../__pycache__/_api.cpython-312.pyc | Bin 0 -> 16800 bytes .../__pycache__/_macos.cpython-312.pyc | Bin 0 -> 19014 bytes .../__pycache__/_openssl.cpython-312.pyc | Bin 0 -> 2232 bytes .../_ssl_constants.cpython-312.pyc | Bin 0 -> 1126 bytes .../__pycache__/_windows.cpython-312.pyc | Bin 0 -> 15792 bytes .../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 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3432 bytes .../__pycache__/_collections.cpython-312.pyc | Bin 0 -> 16391 bytes .../__pycache__/_version.cpython-312.pyc | Bin 0 -> 245 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 20430 bytes .../connectionpool.cpython-312.pyc | Bin 0 -> 36565 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 13520 bytes .../__pycache__/fields.cpython-312.pyc | Bin 0 -> 10429 bytes .../__pycache__/filepost.cpython-312.pyc | Bin 0 -> 4039 bytes .../__pycache__/poolmanager.cpython-312.pyc | Bin 0 -> 20456 bytes .../__pycache__/request.cpython-312.pyc | Bin 0 -> 7321 bytes .../__pycache__/response.cpython-312.pyc | Bin 0 -> 33970 bytes .../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 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 225 bytes .../_appengine_environ.cpython-312.pyc | Bin 0 -> 1875 bytes .../__pycache__/appengine.cpython-312.pyc | Bin 0 -> 11591 bytes .../__pycache__/ntlmpool.cpython-312.pyc | Bin 0 -> 5741 bytes .../__pycache__/pyopenssl.cpython-312.pyc | Bin 0 -> 24475 bytes .../securetransport.cpython-312.pyc | Bin 0 -> 35528 bytes .../contrib/__pycache__/socks.cpython-312.pyc | Bin 0 -> 7538 bytes .../urllib3/contrib/_appengine_environ.py | 36 + .../contrib/_securetransport/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 242 bytes .../__pycache__/bindings.cpython-312.pyc | Bin 0 -> 17454 bytes .../__pycache__/low_level.cpython-312.pyc | Bin 0 -> 14790 bytes .../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 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 226 bytes .../packages/__pycache__/six.cpython-312.pyc | Bin 0 -> 41282 bytes .../urllib3/packages/backports/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 236 bytes .../__pycache__/makefile.cpython-312.pyc | Bin 0 -> 1852 bytes .../weakref_finalize.cpython-312.pyc | Bin 0 -> 7363 bytes .../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 + .../util/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1173 bytes .../__pycache__/connection.cpython-312.pyc | Bin 0 -> 4774 bytes .../util/__pycache__/proxy.cpython-312.pyc | Bin 0 -> 1579 bytes .../util/__pycache__/queue.cpython-312.pyc | Bin 0 -> 1379 bytes .../util/__pycache__/request.cpython-312.pyc | Bin 0 -> 4210 bytes .../util/__pycache__/response.cpython-312.pyc | Bin 0 -> 3019 bytes .../util/__pycache__/retry.cpython-312.pyc | Bin 0 -> 21749 bytes .../util/__pycache__/ssl_.cpython-312.pyc | Bin 0 -> 15391 bytes .../ssl_match_hostname.cpython-312.pyc | Bin 0 -> 5078 bytes .../__pycache__/ssltransport.cpython-312.pyc | Bin 0 -> 10780 bytes .../util/__pycache__/timeout.cpython-312.pyc | Bin 0 -> 11166 bytes .../util/__pycache__/url.cpython-312.pyc | Bin 0 -> 15812 bytes .../util/__pycache__/wait.cpython-312.pyc | Bin 0 -> 4430 bytes .../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 + .../Lib/site-packages/pip/_vendor/vendor.txt | 18 + .venv/Lib/site-packages/pip/py.typed | 4 + .../pydantic-2.10.6.dist-info/INSTALLER | 1 + .../pydantic-2.10.6.dist-info/METADATA | 359 + .../pydantic-2.10.6.dist-info/RECORD | 214 + .../pydantic-2.10.6.dist-info/REQUESTED | 0 .../pydantic-2.10.6.dist-info/WHEEL | 4 + .../licenses/LICENSE | 21 + .venv/Lib/site-packages/pydantic/__init__.py | 431 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 13814 bytes .../__pycache__/_migration.cpython-312.pyc | Bin 0 -> 10911 bytes .../alias_generators.cpython-312.pyc | Bin 0 -> 3303 bytes .../__pycache__/aliases.cpython-312.pyc | Bin 0 -> 6462 bytes .../annotated_handlers.cpython-312.pyc | Bin 0 -> 5517 bytes .../class_validators.cpython-312.pyc | Bin 0 -> 391 bytes .../__pycache__/color.cpython-312.pyc | Bin 0 -> 30226 bytes .../__pycache__/config.cpython-312.pyc | Bin 0 -> 5632 bytes .../__pycache__/dataclasses.cpython-312.pyc | Bin 0 -> 14758 bytes .../datetime_parse.cpython-312.pyc | Bin 0 -> 391 bytes .../__pycache__/decorator.cpython-312.pyc | Bin 0 -> 381 bytes .../__pycache__/env_settings.cpython-312.pyc | Bin 0 -> 387 bytes .../error_wrappers.cpython-312.pyc | Bin 0 -> 391 bytes .../__pycache__/errors.cpython-312.pyc | Bin 0 -> 6348 bytes .../__pycache__/fields.cpython-312.pyc | Bin 0 -> 63256 bytes .../functional_serializers.cpython-312.pyc | Bin 0 -> 18074 bytes .../functional_validators.cpython-312.pyc | Bin 0 -> 32069 bytes .../__pycache__/generics.cpython-312.pyc | Bin 0 -> 379 bytes .../pydantic/__pycache__/json.cpython-312.pyc | Bin 0 -> 371 bytes .../__pycache__/json_schema.cpython-312.pyc | Bin 0 -> 111695 bytes .../pydantic/__pycache__/main.cpython-312.pyc | Bin 0 -> 70469 bytes .../pydantic/__pycache__/mypy.cpython-312.pyc | Bin 0 -> 60381 bytes .../__pycache__/networks.cpython-312.pyc | Bin 0 -> 49074 bytes .../__pycache__/parse.cpython-312.pyc | Bin 0 -> 373 bytes .../__pycache__/root_model.cpython-312.pyc | Bin 0 -> 7815 bytes .../__pycache__/schema.cpython-312.pyc | Bin 0 -> 375 bytes .../__pycache__/tools.cpython-312.pyc | Bin 0 -> 373 bytes .../__pycache__/type_adapter.cpython-312.pyc | Bin 0 -> 30145 bytes .../__pycache__/types.cpython-312.pyc | Bin 0 -> 96415 bytes .../__pycache__/typing.cpython-312.pyc | Bin 0 -> 371 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 373 bytes .../validate_call_decorator.cpython-312.pyc | Bin 0 -> 5440 bytes .../__pycache__/validators.cpython-312.pyc | Bin 0 -> 383 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 3861 bytes .../__pycache__/warnings.cpython-312.pyc | Bin 0 -> 5277 bytes .../pydantic/_internal/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 216 bytes .../__pycache__/_config.cpython-312.pyc | Bin 0 -> 14424 bytes .../_core_metadata.cpython-312.pyc | Bin 0 -> 4108 bytes .../__pycache__/_core_utils.cpython-312.pyc | Bin 0 -> 28934 bytes .../__pycache__/_dataclasses.cpython-312.pyc | Bin 0 -> 10077 bytes .../__pycache__/_decorators.cpython-312.pyc | Bin 0 -> 35209 bytes .../_decorators_v1.cpython-312.pyc | Bin 0 -> 8654 bytes .../_discriminated_union.cpython-312.pyc | Bin 0 -> 21471 bytes .../_docs_extraction.cpython-312.pyc | Bin 0 -> 5231 bytes .../__pycache__/_fields.cpython-312.pyc | Bin 0 -> 15186 bytes .../__pycache__/_forward_ref.cpython-312.pyc | Bin 0 -> 1325 bytes .../_generate_schema.cpython-312.pyc | Bin 0 -> 117872 bytes .../__pycache__/_generics.cpython-312.pyc | Bin 0 -> 23456 bytes .../__pycache__/_git.cpython-312.pyc | Bin 0 -> 1586 bytes .../__pycache__/_import_utils.cpython-312.pyc | Bin 0 -> 906 bytes .../_internal_dataclass.cpython-312.pyc | Bin 0 -> 365 bytes .../_known_annotated_metadata.cpython-312.pyc | Bin 0 -> 13945 bytes .../__pycache__/_mock_val_ser.cpython-312.pyc | Bin 0 -> 11259 bytes .../_model_construction.cpython-312.pyc | Bin 0 -> 33539 bytes .../_namespace_utils.cpython-312.pyc | Bin 0 -> 12151 bytes .../__pycache__/_repr.cpython-312.pyc | Bin 0 -> 7573 bytes .../_schema_generation_shared.cpython-312.pyc | Bin 0 -> 6372 bytes .../__pycache__/_serializers.cpython-312.pyc | Bin 0 -> 1940 bytes .../__pycache__/_signature.cpython-312.pyc | Bin 0 -> 6782 bytes .../_std_types_schema.cpython-312.pyc | Bin 0 -> 19099 bytes .../__pycache__/_typing_extra.cpython-312.pyc | Bin 0 -> 34448 bytes .../__pycache__/_utils.cpython-312.pyc | Bin 0 -> 17049 bytes .../_validate_call.cpython-312.pyc | Bin 0 -> 5773 bytes .../__pycache__/_validators.cpython-312.pyc | Bin 0 -> 17014 bytes .../pydantic/_internal/_config.py | 345 + .../pydantic/_internal/_core_metadata.py | 91 + .../pydantic/_internal/_core_utils.py | 610 ++ .../pydantic/_internal/_dataclasses.py | 246 + .../pydantic/_internal/_decorators.py | 823 ++ .../pydantic/_internal/_decorators_v1.py | 174 + .../_internal/_discriminated_union.py | 503 + .../pydantic/_internal/_docs_extraction.py | 108 + .../pydantic/_internal/_fields.py | 392 + .../pydantic/_internal/_forward_ref.py | 23 + .../pydantic/_internal/_generate_schema.py | 2522 +++++ .../pydantic/_internal/_generics.py | 536 + .../site-packages/pydantic/_internal/_git.py | 27 + .../pydantic/_internal/_import_utils.py | 20 + .../pydantic/_internal/_internal_dataclass.py | 7 + .../_internal/_known_annotated_metadata.py | 392 + .../pydantic/_internal/_mock_val_ser.py | 235 + .../pydantic/_internal/_model_construction.py | 792 ++ .../pydantic/_internal/_namespace_utils.py | 284 + .../site-packages/pydantic/_internal/_repr.py | 123 + .../_internal/_schema_generation_shared.py | 126 + .../pydantic/_internal/_serializers.py | 51 + .../pydantic/_internal/_signature.py | 188 + .../pydantic/_internal/_std_types_schema.py | 404 + .../pydantic/_internal/_typing_extra.py | 893 ++ .../pydantic/_internal/_utils.py | 389 + .../pydantic/_internal/_validate_call.py | 115 + .../pydantic/_internal/_validators.py | 424 + .../Lib/site-packages/pydantic/_migration.py | 308 + .../pydantic/alias_generators.py | 62 + .venv/Lib/site-packages/pydantic/aliases.py | 132 + .../pydantic/annotated_handlers.py | 122 + .../pydantic/class_validators.py | 5 + .venv/Lib/site-packages/pydantic/color.py | 604 ++ .venv/Lib/site-packages/pydantic/config.py | 1049 ++ .../Lib/site-packages/pydantic/dataclasses.py | 366 + .../site-packages/pydantic/datetime_parse.py | 5 + .venv/Lib/site-packages/pydantic/decorator.py | 5 + .../pydantic/deprecated/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 217 bytes .../class_validators.cpython-312.pyc | Bin 0 -> 11760 bytes .../__pycache__/config.cpython-312.pyc | Bin 0 -> 4091 bytes .../copy_internals.cpython-312.pyc | Bin 0 -> 8727 bytes .../__pycache__/decorator.cpython-312.pyc | Bin 0 -> 14064 bytes .../__pycache__/json.cpython-312.pyc | Bin 0 -> 6211 bytes .../__pycache__/parse.cpython-312.pyc | Bin 0 -> 3423 bytes .../__pycache__/tools.cpython-312.pyc | Bin 0 -> 3568 bytes .../pydantic/deprecated/class_validators.py | 256 + .../pydantic/deprecated/config.py | 72 + .../pydantic/deprecated/copy_internals.py | 224 + .../pydantic/deprecated/decorator.py | 283 + .../site-packages/pydantic/deprecated/json.py | 141 + .../pydantic/deprecated/parse.py | 80 + .../pydantic/deprecated/tools.py | 103 + .../site-packages/pydantic/env_settings.py | 5 + .../site-packages/pydantic/error_wrappers.py | 5 + .venv/Lib/site-packages/pydantic/errors.py | 162 + .../pydantic/experimental/__init__.py | 10 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 587 bytes .../__pycache__/pipeline.cpython-312.pyc | Bin 0 -> 34732 bytes .../pydantic/experimental/pipeline.py | 669 ++ .venv/Lib/site-packages/pydantic/fields.py | 1504 +++ .../pydantic/functional_serializers.py | 449 + .../pydantic/functional_validators.py | 825 ++ .venv/Lib/site-packages/pydantic/generics.py | 5 + .venv/Lib/site-packages/pydantic/json.py | 5 + .../Lib/site-packages/pydantic/json_schema.py | 2649 +++++ .venv/Lib/site-packages/pydantic/main.py | 1688 ++++ .venv/Lib/site-packages/pydantic/mypy.py | 1320 +++ .venv/Lib/site-packages/pydantic/networks.py | 1291 +++ .venv/Lib/site-packages/pydantic/parse.py | 5 + .../site-packages/pydantic/plugin/__init__.py | 171 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 7693 bytes .../__pycache__/_loader.cpython-312.pyc | Bin 0 -> 2396 bytes .../_schema_validator.cpython-312.pyc | Bin 0 -> 6907 bytes .../site-packages/pydantic/plugin/_loader.py | 56 + .../pydantic/plugin/_schema_validator.py | 139 + .venv/Lib/site-packages/pydantic/py.typed | 0 .../Lib/site-packages/pydantic/root_model.py | 156 + .venv/Lib/site-packages/pydantic/schema.py | 5 + .venv/Lib/site-packages/pydantic/tools.py | 5 + .../site-packages/pydantic/type_adapter.py | 676 ++ .venv/Lib/site-packages/pydantic/types.py | 3255 ++++++ .venv/Lib/site-packages/pydantic/typing.py | 5 + .venv/Lib/site-packages/pydantic/utils.py | 5 + .../Lib/site-packages/pydantic/v1/__init__.py | 131 + .../v1/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2240 bytes .../_hypothesis_plugin.cpython-312.pyc | Bin 0 -> 20525 bytes .../annotated_types.cpython-312.pyc | Bin 0 -> 3904 bytes .../class_validators.cpython-312.pyc | Bin 0 -> 19664 bytes .../v1/__pycache__/color.cpython-312.pyc | Bin 0 -> 25870 bytes .../v1/__pycache__/config.cpython-312.pyc | Bin 0 -> 8419 bytes .../__pycache__/dataclasses.cpython-312.pyc | Bin 0 -> 22764 bytes .../datetime_parse.cpython-312.pyc | Bin 0 -> 10372 bytes .../v1/__pycache__/decorator.cpython-312.pyc | Bin 0 -> 13937 bytes .../__pycache__/env_settings.cpython-312.pyc | Bin 0 -> 17739 bytes .../error_wrappers.cpython-312.pyc | Bin 0 -> 8947 bytes .../v1/__pycache__/errors.cpython-312.pyc | Bin 0 -> 29622 bytes .../v1/__pycache__/fields.cpython-312.pyc | Bin 0 -> 57462 bytes .../v1/__pycache__/generics.cpython-312.pyc | Bin 0 -> 17012 bytes .../v1/__pycache__/json.cpython-312.pyc | Bin 0 -> 5230 bytes .../v1/__pycache__/main.cpython-312.pyc | Bin 0 -> 48136 bytes .../v1/__pycache__/mypy.cpython-312.pyc | Bin 0 -> 46438 bytes .../v1/__pycache__/networks.cpython-312.pyc | Bin 0 -> 29569 bytes .../v1/__pycache__/parse.cpython-312.pyc | Bin 0 -> 2767 bytes .../v1/__pycache__/schema.cpython-312.pyc | Bin 0 -> 48495 bytes .../v1/__pycache__/tools.cpython-312.pyc | Bin 0 -> 3900 bytes .../v1/__pycache__/types.cpython-312.pyc | Bin 0 -> 48507 bytes .../v1/__pycache__/typing.cpython-312.pyc | Bin 0 -> 22250 bytes .../v1/__pycache__/utils.cpython-312.pyc | Bin 0 -> 35218 bytes .../v1/__pycache__/validators.cpython-312.pyc | Bin 0 -> 30915 bytes .../v1/__pycache__/version.cpython-312.pyc | Bin 0 -> 1978 bytes .../pydantic/v1/_hypothesis_plugin.py | 391 + .../pydantic/v1/annotated_types.py | 72 + .../pydantic/v1/class_validators.py | 361 + .venv/Lib/site-packages/pydantic/v1/color.py | 494 + .venv/Lib/site-packages/pydantic/v1/config.py | 191 + .../site-packages/pydantic/v1/dataclasses.py | 500 + .../pydantic/v1/datetime_parse.py | 248 + .../site-packages/pydantic/v1/decorator.py | 264 + .../site-packages/pydantic/v1/env_settings.py | 350 + .../pydantic/v1/error_wrappers.py | 161 + .venv/Lib/site-packages/pydantic/v1/errors.py | 646 ++ .venv/Lib/site-packages/pydantic/v1/fields.py | 1253 +++ .../Lib/site-packages/pydantic/v1/generics.py | 400 + .venv/Lib/site-packages/pydantic/v1/json.py | 112 + .venv/Lib/site-packages/pydantic/v1/main.py | 1107 +++ .venv/Lib/site-packages/pydantic/v1/mypy.py | 949 ++ .../Lib/site-packages/pydantic/v1/networks.py | 747 ++ .venv/Lib/site-packages/pydantic/v1/parse.py | 66 + .venv/Lib/site-packages/pydantic/v1/py.typed | 0 .venv/Lib/site-packages/pydantic/v1/schema.py | 1163 +++ .venv/Lib/site-packages/pydantic/v1/tools.py | 92 + .venv/Lib/site-packages/pydantic/v1/types.py | 1205 +++ .venv/Lib/site-packages/pydantic/v1/typing.py | 608 ++ .venv/Lib/site-packages/pydantic/v1/utils.py | 804 ++ .../site-packages/pydantic/v1/validators.py | 768 ++ .../Lib/site-packages/pydantic/v1/version.py | 38 + .../pydantic/validate_call_decorator.py | 115 + .../Lib/site-packages/pydantic/validators.py | 5 + .venv/Lib/site-packages/pydantic/version.py | 78 + .venv/Lib/site-packages/pydantic/warnings.py | 86 + .../pydantic_core-2.27.2.dist-info/INSTALLER | 1 + .../pydantic_core-2.27.2.dist-info/METADATA | 161 + .../pydantic_core-2.27.2.dist-info/RECORD | 12 + .../pydantic_core-2.27.2.dist-info/WHEEL | 4 + .../licenses/LICENSE | 21 + .../site-packages/pydantic_core/__init__.py | 139 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3087 bytes .../__pycache__/core_schema.cpython-312.pyc | Bin 0 -> 146480 bytes .../_pydantic_core.cp312-win_amd64.pyd | Bin 0 -> 5285376 bytes .../pydantic_core/_pydantic_core.pyi | 1013 ++ .../pydantic_core/core_schema.py | 4211 ++++++++ .../Lib/site-packages/pydantic_core/py.typed | 0 .../sniffio-1.3.1.dist-info/INSTALLER | 1 + .../sniffio-1.3.1.dist-info/LICENSE | 3 + .../sniffio-1.3.1.dist-info/LICENSE.APACHE2 | 202 + .../sniffio-1.3.1.dist-info/LICENSE.MIT | 20 + .../sniffio-1.3.1.dist-info/METADATA | 104 + .../sniffio-1.3.1.dist-info/RECORD | 19 + .../sniffio-1.3.1.dist-info/WHEEL | 5 + .../sniffio-1.3.1.dist-info/top_level.txt | 1 + .venv/Lib/site-packages/sniffio/__init__.py | 17 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 481 bytes .../sniffio/__pycache__/_impl.cpython-312.pyc | Bin 0 -> 3192 bytes .../__pycache__/_version.cpython-312.pyc | Bin 0 -> 233 bytes .venv/Lib/site-packages/sniffio/_impl.py | 95 + .../site-packages/sniffio/_tests/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 212 bytes .../__pycache__/test_sniffio.cpython-312.pyc | Bin 0 -> 3873 bytes .../sniffio/_tests/test_sniffio.py | 84 + .venv/Lib/site-packages/sniffio/_version.py | 3 + .venv/Lib/site-packages/sniffio/py.typed | 0 .../sqlalchemy-2.0.39.dist-info/INSTALLER | 1 + .../sqlalchemy-2.0.39.dist-info/LICENSE | 19 + .../sqlalchemy-2.0.39.dist-info/METADATA | 243 + .../sqlalchemy-2.0.39.dist-info/RECORD | 530 + .../sqlalchemy-2.0.39.dist-info/REQUESTED | 0 .../sqlalchemy-2.0.39.dist-info/WHEEL | 5 + .../sqlalchemy-2.0.39.dist-info/top_level.txt | 1 + .../Lib/site-packages/sqlalchemy/__init__.py | 294 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 9963 bytes .../__pycache__/events.cpython-312.pyc | Bin 0 -> 581 bytes .../__pycache__/exc.cpython-312.pyc | Bin 0 -> 31252 bytes .../__pycache__/inspection.cpython-312.pyc | Bin 0 -> 6680 bytes .../__pycache__/log.cpython-312.pyc | Bin 0 -> 11638 bytes .../__pycache__/schema.cpython-312.pyc | Bin 0 -> 2360 bytes .../__pycache__/types.cpython-312.pyc | Bin 0 -> 2308 bytes .../sqlalchemy/connectors/__init__.py | 18 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 620 bytes .../__pycache__/aioodbc.cpython-312.pyc | Bin 0 -> 7085 bytes .../__pycache__/asyncio.cpython-312.pyc | Bin 0 -> 12406 bytes .../__pycache__/pyodbc.cpython-312.pyc | Bin 0 -> 9400 bytes .../sqlalchemy/connectors/aioodbc.py | 174 + .../sqlalchemy/connectors/asyncio.py | 213 + .../sqlalchemy/connectors/pyodbc.py | 249 + .../sqlalchemy/cyextension/__init__.py | 6 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 220 bytes .../collections.cp312-win_amd64.pyd | Bin 0 -> 176640 bytes .../sqlalchemy/cyextension/collections.pyx | 409 + .../immutabledict.cp312-win_amd64.pyd | Bin 0 -> 72704 bytes .../sqlalchemy/cyextension/immutabledict.pxd | 8 + .../sqlalchemy/cyextension/immutabledict.pyx | 133 + .../processors.cp312-win_amd64.pyd | Bin 0 -> 59392 bytes .../sqlalchemy/cyextension/processors.pyx | 68 + .../resultproxy.cp312-win_amd64.pyd | Bin 0 -> 61952 bytes .../sqlalchemy/cyextension/resultproxy.pyx | 102 + .../cyextension/util.cp312-win_amd64.pyd | Bin 0 -> 73728 bytes .../sqlalchemy/cyextension/util.pyx | 91 + .../sqlalchemy/dialects/__init__.py | 61 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1907 bytes .../__pycache__/_typing.cpython-312.pyc | Bin 0 -> 1110 bytes .../sqlalchemy/dialects/_typing.py | 30 + .../sqlalchemy/dialects/mssql/__init__.py | 88 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1688 bytes .../mssql/__pycache__/aioodbc.cpython-312.pyc | Bin 0 -> 2429 bytes .../mssql/__pycache__/base.cpython-312.pyc | Bin 0 -> 152623 bytes .../information_schema.cpython-312.pyc | Bin 0 -> 8100 bytes .../mssql/__pycache__/json.cpython-312.pyc | Bin 0 -> 5250 bytes .../__pycache__/provision.cpython-312.pyc | Bin 0 -> 7420 bytes .../mssql/__pycache__/pymssql.cpython-312.pyc | Bin 0 -> 5980 bytes .../mssql/__pycache__/pyodbc.cpython-312.pyc | Bin 0 -> 30658 bytes .../sqlalchemy/dialects/mssql/aioodbc.py | 63 + .../sqlalchemy/dialects/mssql/base.py | 4058 ++++++++ .../dialects/mssql/information_schema.py | 254 + .../sqlalchemy/dialects/mssql/json.py | 129 + .../sqlalchemy/dialects/mssql/provision.py | 162 + .../sqlalchemy/dialects/mssql/pymssql.py | 126 + .../sqlalchemy/dialects/mssql/pyodbc.py | 760 ++ .../sqlalchemy/dialects/mysql/__init__.py | 104 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2017 bytes .../__pycache__/aiomysql.cpython-312.pyc | Bin 0 -> 16926 bytes .../mysql/__pycache__/asyncmy.cpython-312.pyc | Bin 0 -> 17378 bytes .../mysql/__pycache__/base.cpython-312.pyc | Bin 0 -> 141040 bytes .../mysql/__pycache__/cymysql.cpython-312.pyc | Bin 0 -> 3158 bytes .../mysql/__pycache__/dml.cpython-312.pyc | Bin 0 -> 8379 bytes .../__pycache__/enumerated.cpython-312.pyc | Bin 0 -> 10217 bytes .../__pycache__/expression.cpython-312.pyc | Bin 0 -> 5066 bytes .../mysql/__pycache__/json.cpython-312.pyc | Bin 0 -> 3472 bytes .../mysql/__pycache__/mariadb.cpython-312.pyc | Bin 0 -> 2273 bytes .../mariadbconnector.cpython-312.pyc | Bin 0 -> 11705 bytes .../mysqlconnector.cpython-312.pyc | Bin 0 -> 9197 bytes .../mysql/__pycache__/mysqldb.cpython-312.pyc | Bin 0 -> 11791 bytes .../__pycache__/provision.cpython-312.pyc | Bin 0 -> 4269 bytes .../mysql/__pycache__/pymysql.cpython-312.pyc | Bin 0 -> 5330 bytes .../mysql/__pycache__/pyodbc.cpython-312.pyc | Bin 0 -> 5286 bytes .../__pycache__/reflection.cpython-312.pyc | Bin 0 -> 24079 bytes .../reserved_words.cpython-312.pyc | Bin 0 -> 4417 bytes .../mysql/__pycache__/types.cpython-312.pyc | Bin 0 -> 30493 bytes .../sqlalchemy/dialects/mysql/aiomysql.py | 335 + .../sqlalchemy/dialects/mysql/asyncmy.py | 339 + .../sqlalchemy/dialects/mysql/base.py | 3575 +++++++ .../sqlalchemy/dialects/mysql/cymysql.py | 84 + .../sqlalchemy/dialects/mysql/dml.py | 225 + .../sqlalchemy/dialects/mysql/enumerated.py | 243 + .../sqlalchemy/dialects/mysql/expression.py | 143 + .../sqlalchemy/dialects/mysql/json.py | 81 + .../sqlalchemy/dialects/mysql/mariadb.py | 61 + .../dialects/mysql/mariadbconnector.py | 277 + .../dialects/mysql/mysqlconnector.py | 180 + .../sqlalchemy/dialects/mysql/mysqldb.py | 305 + .../sqlalchemy/dialects/mysql/provision.py | 110 + .../sqlalchemy/dialects/mysql/pymysql.py | 136 + .../sqlalchemy/dialects/mysql/pyodbc.py | 139 + .../sqlalchemy/dialects/mysql/reflection.py | 677 ++ .../dialects/mysql/reserved_words.py | 571 ++ .../sqlalchemy/dialects/mysql/types.py | 774 ++ .../sqlalchemy/dialects/oracle/__init__.py | 67 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1374 bytes .../oracle/__pycache__/base.cpython-312.pyc | Bin 0 -> 142966 bytes .../__pycache__/cx_oracle.cpython-312.pyc | Bin 0 -> 60745 bytes .../__pycache__/dictionary.cpython-312.pyc | Bin 0 -> 24624 bytes .../__pycache__/oracledb.cpython-312.pyc | Bin 0 -> 41490 bytes .../__pycache__/provision.cpython-312.pyc | Bin 0 -> 10791 bytes .../oracle/__pycache__/types.cpython-312.pyc | Bin 0 -> 13238 bytes .../sqlalchemy/dialects/oracle/base.py | 3484 +++++++ .../sqlalchemy/dialects/oracle/cx_oracle.py | 1552 +++ .../sqlalchemy/dialects/oracle/dictionary.py | 507 + .../sqlalchemy/dialects/oracle/oracledb.py | 947 ++ .../sqlalchemy/dialects/oracle/provision.py | 220 + .../sqlalchemy/dialects/oracle/types.py | 316 + .../dialects/postgresql/__init__.py | 167 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3458 bytes .../_psycopg_common.cpython-312.pyc | Bin 0 -> 7725 bytes .../__pycache__/array.cpython-312.pyc | Bin 0 -> 16732 bytes .../__pycache__/asyncpg.cpython-312.pyc | Bin 0 -> 58226 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 205023 bytes .../__pycache__/dml.cpython-312.pyc | Bin 0 -> 12622 bytes .../__pycache__/ext.cpython-312.pyc | Bin 0 -> 19334 bytes .../__pycache__/hstore.cpython-312.pyc | Bin 0 -> 15393 bytes .../__pycache__/json.cpython-312.pyc | Bin 0 -> 15185 bytes .../__pycache__/named_types.cpython-312.pyc | Bin 0 -> 22898 bytes .../__pycache__/operators.cpython-312.pyc | Bin 0 -> 2181 bytes .../__pycache__/pg8000.cpython-312.pyc | Bin 0 -> 30283 bytes .../__pycache__/pg_catalog.cpython-312.pyc | Bin 0 -> 10986 bytes .../__pycache__/provision.cpython-312.pyc | Bin 0 -> 7737 bytes .../__pycache__/psycopg.cpython-312.pyc | Bin 0 -> 37588 bytes .../__pycache__/psycopg2.cpython-312.pyc | Bin 0 -> 35997 bytes .../__pycache__/psycopg2cffi.cpython-312.pyc | Bin 0 -> 2188 bytes .../__pycache__/ranges.cpython-312.pyc | Bin 0 -> 34793 bytes .../__pycache__/types.cpython-312.pyc | Bin 0 -> 11541 bytes .../dialects/postgresql/_psycopg_common.py | 187 + .../sqlalchemy/dialects/postgresql/array.py | 435 + .../sqlalchemy/dialects/postgresql/asyncpg.py | 1287 +++ .../sqlalchemy/dialects/postgresql/base.py | 5041 ++++++++++ .../sqlalchemy/dialects/postgresql/dml.py | 339 + .../sqlalchemy/dialects/postgresql/ext.py | 501 + .../sqlalchemy/dialects/postgresql/hstore.py | 406 + .../sqlalchemy/dialects/postgresql/json.py | 367 + .../dialects/postgresql/named_types.py | 505 + .../dialects/postgresql/operators.py | 129 + .../sqlalchemy/dialects/postgresql/pg8000.py | 666 ++ .../dialects/postgresql/pg_catalog.py | 300 + .../dialects/postgresql/provision.py | 175 + .../sqlalchemy/dialects/postgresql/psycopg.py | 783 ++ .../dialects/postgresql/psycopg2.py | 892 ++ .../dialects/postgresql/psycopg2cffi.py | 61 + .../sqlalchemy/dialects/postgresql/ranges.py | 1031 ++ .../sqlalchemy/dialects/postgresql/types.py | 313 + .../sqlalchemy/dialects/sqlite/__init__.py | 57 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1084 bytes .../__pycache__/aiosqlite.cpython-312.pyc | Bin 0 -> 18788 bytes .../sqlite/__pycache__/base.cpython-312.pyc | Bin 0 -> 101697 bytes .../sqlite/__pycache__/dml.cpython-312.pyc | Bin 0 -> 10077 bytes .../sqlite/__pycache__/json.cpython-312.pyc | Bin 0 -> 3801 bytes .../__pycache__/provision.cpython-312.pyc | Bin 0 -> 7302 bytes .../__pycache__/pysqlcipher.cpython-312.pyc | Bin 0 -> 6236 bytes .../__pycache__/pysqlite.cpython-312.pyc | Bin 0 -> 31465 bytes .../sqlalchemy/dialects/sqlite/aiosqlite.py | 421 + .../sqlalchemy/dialects/sqlite/base.py | 2866 ++++++ .../sqlalchemy/dialects/sqlite/dml.py | 263 + .../sqlalchemy/dialects/sqlite/json.py | 92 + .../sqlalchemy/dialects/sqlite/provision.py | 198 + .../sqlalchemy/dialects/sqlite/pysqlcipher.py | 157 + .../sqlalchemy/dialects/sqlite/pysqlite.py | 771 ++ .../dialects/type_migration_guidelines.txt | 145 + .../sqlalchemy/engine/__init__.py | 62 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2299 bytes .../_py_processors.cpython-312.pyc | Bin 0 -> 4522 bytes .../__pycache__/_py_row.cpython-312.pyc | Bin 0 -> 5791 bytes .../__pycache__/_py_util.cpython-312.pyc | Bin 0 -> 2203 bytes .../engine/__pycache__/base.cpython-312.pyc | Bin 0 -> 129989 bytes .../characteristics.cpython-312.pyc | Bin 0 -> 6866 bytes .../engine/__pycache__/create.cpython-312.pyc | Bin 0 -> 34350 bytes .../engine/__pycache__/cursor.cpython-312.pyc | Bin 0 -> 79404 bytes .../__pycache__/default.cpython-312.pyc | Bin 0 -> 88115 bytes .../engine/__pycache__/events.cpython-312.pyc | Bin 0 -> 39945 bytes .../__pycache__/interfaces.cpython-312.pyc | Bin 0 -> 99631 bytes .../engine/__pycache__/mock.cpython-312.pyc | Bin 0 -> 5715 bytes .../__pycache__/processors.cpython-312.pyc | Bin 0 -> 1313 bytes .../__pycache__/reflection.cpython-312.pyc | Bin 0 -> 80328 bytes .../engine/__pycache__/result.cpython-312.pyc | Bin 0 -> 91247 bytes .../engine/__pycache__/row.cpython-312.pyc | Bin 0 -> 17461 bytes .../__pycache__/strategies.cpython-312.pyc | Bin 0 -> 582 bytes .../engine/__pycache__/url.cpython-312.pyc | Bin 0 -> 34433 bytes .../engine/__pycache__/util.cpython-312.pyc | Bin 0 -> 6658 bytes .../sqlalchemy/engine/_py_processors.py | 136 + .../sqlalchemy/engine/_py_row.py | 128 + .../sqlalchemy/engine/_py_util.py | 74 + .../site-packages/sqlalchemy/engine/base.py | 3371 +++++++ .../sqlalchemy/engine/characteristics.py | 155 + .../site-packages/sqlalchemy/engine/create.py | 878 ++ .../site-packages/sqlalchemy/engine/cursor.py | 2176 +++++ .../sqlalchemy/engine/default.py | 2367 +++++ .../site-packages/sqlalchemy/engine/events.py | 965 ++ .../sqlalchemy/engine/interfaces.py | 3406 +++++++ .../site-packages/sqlalchemy/engine/mock.py | 133 + .../sqlalchemy/engine/processors.py | 61 + .../sqlalchemy/engine/reflection.py | 2099 ++++ .../site-packages/sqlalchemy/engine/result.py | 2380 +++++ .../site-packages/sqlalchemy/engine/row.py | 400 + .../sqlalchemy/engine/strategies.py | 19 + .../site-packages/sqlalchemy/engine/url.py | 924 ++ .../site-packages/sqlalchemy/engine/util.py | 167 + .../sqlalchemy/event/__init__.py | 25 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 862 bytes .../event/__pycache__/api.cpython-312.pyc | Bin 0 -> 9099 bytes .../event/__pycache__/attr.cpython-312.pyc | Bin 0 -> 30384 bytes .../event/__pycache__/base.cpython-312.pyc | Bin 0 -> 19984 bytes .../event/__pycache__/legacy.cpython-312.pyc | Bin 0 -> 9403 bytes .../__pycache__/registry.cpython-312.pyc | Bin 0 -> 12620 bytes .../Lib/site-packages/sqlalchemy/event/api.py | 222 + .../site-packages/sqlalchemy/event/attr.py | 655 ++ .../site-packages/sqlalchemy/event/base.py | 472 + .../site-packages/sqlalchemy/event/legacy.py | 246 + .../sqlalchemy/event/registry.py | 390 + .venv/Lib/site-packages/sqlalchemy/events.py | 17 + .venv/Lib/site-packages/sqlalchemy/exc.py | 832 ++ .../site-packages/sqlalchemy/ext/__init__.py | 11 + .../ext/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 375 bytes .../associationproxy.cpython-312.pyc | Bin 0 -> 86885 bytes .../ext/__pycache__/automap.cpython-312.pyc | Bin 0 -> 57423 bytes .../ext/__pycache__/baked.cpython-312.pyc | Bin 0 -> 23410 bytes .../ext/__pycache__/compiler.cpython-312.pyc | Bin 0 -> 21259 bytes .../horizontal_shard.cpython-312.pyc | Bin 0 -> 17670 bytes .../ext/__pycache__/hybrid.cpython-312.pyc | Bin 0 -> 59859 bytes .../ext/__pycache__/indexable.cpython-312.pyc | Bin 0 -> 12214 bytes .../instrumentation.cpython-312.pyc | Bin 0 -> 19891 bytes .../ext/__pycache__/mutable.cpython-312.pyc | Bin 0 -> 46347 bytes .../__pycache__/orderinglist.cpython-312.pyc | Bin 0 -> 17340 bytes .../__pycache__/serializer.cpython-312.pyc | Bin 0 -> 8070 bytes .../sqlalchemy/ext/associationproxy.py | 2013 ++++ .../sqlalchemy/ext/asyncio/__init__.py | 25 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 998 bytes .../asyncio/__pycache__/base.cpython-312.pyc | Bin 0 -> 11227 bytes .../__pycache__/engine.cpython-312.pyc | Bin 0 -> 57417 bytes .../asyncio/__pycache__/exc.cpython-312.pyc | Bin 0 -> 1058 bytes .../__pycache__/result.cpython-312.pyc | Bin 0 -> 37524 bytes .../__pycache__/scoping.cpython-312.pyc | Bin 0 -> 57026 bytes .../__pycache__/session.cpython-312.pyc | Bin 0 -> 71496 bytes .../sqlalchemy/ext/asyncio/base.py | 281 + .../sqlalchemy/ext/asyncio/engine.py | 1467 +++ .../sqlalchemy/ext/asyncio/exc.py | 21 + .../sqlalchemy/ext/asyncio/result.py | 962 ++ .../sqlalchemy/ext/asyncio/scoping.py | 1614 +++ .../sqlalchemy/ext/asyncio/session.py | 1943 ++++ .../site-packages/sqlalchemy/ext/automap.py | 1701 ++++ .../Lib/site-packages/sqlalchemy/ext/baked.py | 570 ++ .../site-packages/sqlalchemy/ext/compiler.py | 600 ++ .../sqlalchemy/ext/declarative/__init__.py | 65 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2034 bytes .../__pycache__/extensions.cpython-312.pyc | Bin 0 -> 21257 bytes .../sqlalchemy/ext/declarative/extensions.py | 564 ++ .../sqlalchemy/ext/horizontal_shard.py | 478 + .../site-packages/sqlalchemy/ext/hybrid.py | 1533 +++ .../site-packages/sqlalchemy/ext/indexable.py | 345 + .../sqlalchemy/ext/instrumentation.py | 450 + .../site-packages/sqlalchemy/ext/mutable.py | 1095 +++ .../sqlalchemy/ext/mypy/__init__.py | 6 + .../mypy/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 217 bytes .../mypy/__pycache__/apply.cpython-312.pyc | Bin 0 -> 10535 bytes .../__pycache__/decl_class.cpython-312.pyc | Bin 0 -> 15841 bytes .../mypy/__pycache__/infer.cpython-312.pyc | Bin 0 -> 15647 bytes .../mypy/__pycache__/names.cpython-312.pyc | Bin 0 -> 11060 bytes .../mypy/__pycache__/plugin.cpython-312.pyc | Bin 0 -> 12536 bytes .../ext/mypy/__pycache__/util.cpython-312.pyc | Bin 0 -> 14031 bytes .../sqlalchemy/ext/mypy/apply.py | 324 + .../sqlalchemy/ext/mypy/decl_class.py | 515 + .../sqlalchemy/ext/mypy/infer.py | 590 ++ .../sqlalchemy/ext/mypy/names.py | 335 + .../sqlalchemy/ext/mypy/plugin.py | 303 + .../site-packages/sqlalchemy/ext/mypy/util.py | 357 + .../sqlalchemy/ext/orderinglist.py | 427 + .../sqlalchemy/ext/serializer.py | 185 + .../sqlalchemy/future/__init__.py | 16 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 485 bytes .../future/__pycache__/engine.cpython-312.pyc | Bin 0 -> 418 bytes .../site-packages/sqlalchemy/future/engine.py | 15 + .../site-packages/sqlalchemy/inspection.py | 174 + .venv/Lib/site-packages/sqlalchemy/log.py | 288 + .../site-packages/sqlalchemy/orm/__init__.py | 170 + .../orm/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 6366 bytes .../_orm_constructors.cpython-312.pyc | Bin 0 -> 105431 bytes .../orm/__pycache__/_typing.cpython-312.pyc | Bin 0 -> 6835 bytes .../__pycache__/attributes.cpython-312.pyc | Bin 0 -> 99872 bytes .../orm/__pycache__/base.cpython-312.pyc | Bin 0 -> 30371 bytes .../bulk_persistence.cpython-312.pyc | Bin 0 -> 64447 bytes .../__pycache__/clsregistry.cpython-312.pyc | Bin 0 -> 23798 bytes .../__pycache__/collections.cpython-312.pyc | Bin 0 -> 61746 bytes .../orm/__pycache__/context.cpython-312.pyc | Bin 0 -> 103187 bytes .../orm/__pycache__/decl_api.cpython-312.pyc | Bin 0 -> 67394 bytes .../orm/__pycache__/decl_base.cpython-312.pyc | Bin 0 -> 68867 bytes .../__pycache__/dependency.cpython-312.pyc | Bin 0 -> 43144 bytes .../descriptor_props.cpython-312.pyc | Bin 0 -> 48908 bytes .../orm/__pycache__/dynamic.cpython-312.pyc | Bin 0 -> 12964 bytes .../orm/__pycache__/evaluator.cpython-312.pyc | Bin 0 -> 16770 bytes .../orm/__pycache__/events.cpython-312.pyc | Bin 0 -> 137150 bytes .../orm/__pycache__/exc.cpython-312.pyc | Bin 0 -> 9875 bytes .../orm/__pycache__/identity.cpython-312.pyc | Bin 0 -> 12638 bytes .../instrumentation.cpython-312.pyc | Bin 0 -> 31221 bytes .../__pycache__/interfaces.cpython-312.pyc | Bin 0 -> 54289 bytes .../orm/__pycache__/loading.cpython-312.pyc | Bin 0 -> 46880 bytes .../mapped_collection.cpython-312.pyc | Bin 0 -> 21909 bytes .../orm/__pycache__/mapper.cpython-312.pyc | Bin 0 -> 168726 bytes .../__pycache__/path_registry.cpython-312.pyc | Bin 0 -> 31520 bytes .../__pycache__/persistence.cpython-312.pyc | Bin 0 -> 48259 bytes .../__pycache__/properties.cpython-312.pyc | Bin 0 -> 32794 bytes .../orm/__pycache__/query.cpython-312.pyc | Bin 0 -> 128698 bytes .../__pycache__/relationships.cpython-312.pyc | Bin 0 -> 130441 bytes .../orm/__pycache__/scoping.cpython-312.pyc | Bin 0 -> 83622 bytes .../orm/__pycache__/session.cpython-312.pyc | Bin 0 -> 203339 bytes .../orm/__pycache__/state.cpython-312.pyc | Bin 0 -> 45134 bytes .../__pycache__/state_changes.cpython-312.pyc | Bin 0 -> 7047 bytes .../__pycache__/strategies.cpython-312.pyc | Bin 0 -> 105116 bytes .../strategy_options.cpython-312.pyc | Bin 0 -> 86767 bytes .../orm/__pycache__/sync.cpython-312.pyc | Bin 0 -> 6594 bytes .../__pycache__/unitofwork.cpython-312.pyc | Bin 0 -> 34055 bytes .../orm/__pycache__/util.cpython-312.pyc | Bin 0 -> 85009 bytes .../orm/__pycache__/writeonly.cpython-312.pyc | Bin 0 -> 28829 bytes .../sqlalchemy/orm/_orm_constructors.py | 2590 +++++ .../site-packages/sqlalchemy/orm/_typing.py | 179 + .../sqlalchemy/orm/attributes.py | 2835 ++++++ .../Lib/site-packages/sqlalchemy/orm/base.py | 973 ++ .../sqlalchemy/orm/bulk_persistence.py | 2123 ++++ .../sqlalchemy/orm/clsregistry.py | 571 ++ .../sqlalchemy/orm/collections.py | 1627 +++ .../site-packages/sqlalchemy/orm/context.py | 3336 +++++++ .../site-packages/sqlalchemy/orm/decl_api.py | 1917 ++++ .../site-packages/sqlalchemy/orm/decl_base.py | 2188 +++++ .../sqlalchemy/orm/dependency.py | 1304 +++ .../sqlalchemy/orm/descriptor_props.py | 1077 ++ .../site-packages/sqlalchemy/orm/dynamic.py | 300 + .../site-packages/sqlalchemy/orm/evaluator.py | 379 + .../site-packages/sqlalchemy/orm/events.py | 3271 +++++++ .venv/Lib/site-packages/sqlalchemy/orm/exc.py | 228 + .../site-packages/sqlalchemy/orm/identity.py | 302 + .../sqlalchemy/orm/instrumentation.py | 754 ++ .../sqlalchemy/orm/interfaces.py | 1490 +++ .../site-packages/sqlalchemy/orm/loading.py | 1682 ++++ .../sqlalchemy/orm/mapped_collection.py | 557 ++ .../site-packages/sqlalchemy/orm/mapper.py | 4431 +++++++++ .../sqlalchemy/orm/path_registry.py | 811 ++ .../sqlalchemy/orm/persistence.py | 1782 ++++ .../sqlalchemy/orm/properties.py | 877 ++ .../Lib/site-packages/sqlalchemy/orm/query.py | 3454 +++++++ .../sqlalchemy/orm/relationships.py | 3514 +++++++ .../site-packages/sqlalchemy/orm/scoping.py | 2163 ++++ .../site-packages/sqlalchemy/orm/session.py | 5302 ++++++++++ .../Lib/site-packages/sqlalchemy/orm/state.py | 1143 +++ .../sqlalchemy/orm/state_changes.py | 198 + .../sqlalchemy/orm/strategies.py | 3473 +++++++ .../sqlalchemy/orm/strategy_options.py | 2550 +++++ .../Lib/site-packages/sqlalchemy/orm/sync.py | 164 + .../sqlalchemy/orm/unitofwork.py | 796 ++ .../Lib/site-packages/sqlalchemy/orm/util.py | 2402 +++++ .../site-packages/sqlalchemy/orm/writeonly.py | 678 ++ .../site-packages/sqlalchemy/pool/__init__.py | 44 + .../pool/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1536 bytes .../pool/__pycache__/base.cpython-312.pyc | Bin 0 -> 56298 bytes .../pool/__pycache__/events.cpython-312.pyc | Bin 0 -> 14347 bytes .../pool/__pycache__/impl.cpython-312.pyc | Bin 0 -> 25921 bytes .../Lib/site-packages/sqlalchemy/pool/base.py | 1516 +++ .../site-packages/sqlalchemy/pool/events.py | 372 + .../Lib/site-packages/sqlalchemy/pool/impl.py | 581 ++ .venv/Lib/site-packages/sqlalchemy/py.typed | 0 .venv/Lib/site-packages/sqlalchemy/schema.py | 70 + .../site-packages/sqlalchemy/sql/__init__.py | 145 + .../sql/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4709 bytes .../_dml_constructors.cpython-312.pyc | Bin 0 -> 4017 bytes .../_elements_constructors.cpython-312.pyc | Bin 0 -> 65599 bytes .../__pycache__/_orm_types.cpython-312.pyc | Bin 0 -> 649 bytes .../sql/__pycache__/_py_util.cpython-312.pyc | Bin 0 -> 2988 bytes .../_selectable_constructors.cpython-312.pyc | Bin 0 -> 23322 bytes .../sql/__pycache__/_typing.cpython-312.pyc | Bin 0 -> 14925 bytes .../__pycache__/annotation.cpython-312.pyc | Bin 0 -> 21361 bytes .../sql/__pycache__/base.cpython-312.pyc | Bin 0 -> 97915 bytes .../sql/__pycache__/cache_key.cpython-312.pyc | Bin 0 -> 35666 bytes .../sql/__pycache__/coercions.cpython-312.pyc | Bin 0 -> 48957 bytes .../sql/__pycache__/compiler.cpython-312.pyc | Bin 0 -> 271995 bytes .../sql/__pycache__/crud.cpython-312.pyc | Bin 0 -> 45492 bytes .../sql/__pycache__/ddl.cpython-312.pyc | Bin 0 -> 57862 bytes .../default_comparator.cpython-312.pyc | Bin 0 -> 19505 bytes .../sql/__pycache__/dml.cpython-312.pyc | Bin 0 -> 74297 bytes .../sql/__pycache__/elements.cpython-312.pyc | Bin 0 -> 211645 bytes .../sql/__pycache__/events.cpython-312.pyc | Bin 0 -> 19244 bytes .../__pycache__/expression.cpython-312.pyc | Bin 0 -> 5171 bytes .../sql/__pycache__/functions.cpython-312.pyc | Bin 0 -> 75805 bytes .../sql/__pycache__/lambdas.cpython-312.pyc | Bin 0 -> 54871 bytes .../sql/__pycache__/naming.cpython-312.pyc | Bin 0 -> 8486 bytes .../sql/__pycache__/operators.cpython-312.pyc | Bin 0 -> 89914 bytes .../sql/__pycache__/roles.cpython-312.pyc | Bin 0 -> 12268 bytes .../sql/__pycache__/schema.cpython-312.pyc | Bin 0 -> 245600 bytes .../__pycache__/selectable.cpython-312.pyc | Bin 0 -> 261355 bytes .../sql/__pycache__/sqltypes.cpython-312.pyc | Bin 0 -> 151715 bytes .../__pycache__/traversals.cpython-312.pyc | Bin 0 -> 42371 bytes .../sql/__pycache__/type_api.cpython-312.pyc | Bin 0 -> 87190 bytes .../sql/__pycache__/util.cpython-312.pyc | Bin 0 -> 54370 bytes .../sql/__pycache__/visitors.cpython-312.pyc | Bin 0 -> 36094 bytes .../sqlalchemy/sql/_dml_constructors.py | 132 + .../sqlalchemy/sql/_elements_constructors.py | 1862 ++++ .../sqlalchemy/sql/_orm_types.py | 20 + .../site-packages/sqlalchemy/sql/_py_util.py | 75 + .../sql/_selectable_constructors.py | 713 ++ .../site-packages/sqlalchemy/sql/_typing.py | 463 + .../sqlalchemy/sql/annotation.py | 585 ++ .../Lib/site-packages/sqlalchemy/sql/base.py | 2185 +++++ .../site-packages/sqlalchemy/sql/cache_key.py | 1057 ++ .../site-packages/sqlalchemy/sql/coercions.py | 1403 +++ .../site-packages/sqlalchemy/sql/compiler.py | 7840 +++++++++++++++ .../Lib/site-packages/sqlalchemy/sql/crud.py | 1669 ++++ .venv/Lib/site-packages/sqlalchemy/sql/ddl.py | 1438 +++ .../sqlalchemy/sql/default_comparator.py | 552 ++ .venv/Lib/site-packages/sqlalchemy/sql/dml.py | 1837 ++++ .../site-packages/sqlalchemy/sql/elements.py | 5537 +++++++++++ .../site-packages/sqlalchemy/sql/events.py | 458 + .../sqlalchemy/sql/expression.py | 162 + .../site-packages/sqlalchemy/sql/functions.py | 2064 ++++ .../site-packages/sqlalchemy/sql/lambdas.py | 1443 +++ .../site-packages/sqlalchemy/sql/naming.py | 212 + .../site-packages/sqlalchemy/sql/operators.py | 2623 +++++ .../Lib/site-packages/sqlalchemy/sql/roles.py | 323 + .../site-packages/sqlalchemy/sql/schema.py | 6201 ++++++++++++ .../sqlalchemy/sql/selectable.py | 7183 ++++++++++++++ .../site-packages/sqlalchemy/sql/sqltypes.py | 3844 ++++++++ .../sqlalchemy/sql/traversals.py | 1024 ++ .../site-packages/sqlalchemy/sql/type_api.py | 2358 +++++ .../Lib/site-packages/sqlalchemy/sql/util.py | 1487 +++ .../site-packages/sqlalchemy/sql/visitors.py | 1167 +++ .../sqlalchemy/testing/__init__.py | 96 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3353 bytes .../__pycache__/assertions.cpython-312.pyc | Bin 0 -> 41783 bytes .../__pycache__/assertsql.cpython-312.pyc | Bin 0 -> 20221 bytes .../__pycache__/asyncio.cpython-312.pyc | Bin 0 -> 4173 bytes .../__pycache__/config.cpython-312.pyc | Bin 0 -> 17652 bytes .../__pycache__/engines.cpython-312.pyc | Bin 0 -> 21419 bytes .../__pycache__/entities.cpython-312.pyc | Bin 0 -> 5007 bytes .../__pycache__/exclusions.cpython-312.pyc | Bin 0 -> 21265 bytes .../__pycache__/pickleable.cpython-312.pyc | Bin 0 -> 6712 bytes .../__pycache__/profiling.cpython-312.pyc | Bin 0 -> 13008 bytes .../__pycache__/provision.cpython-312.pyc | Bin 0 -> 21083 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 86990 bytes .../__pycache__/schema.cpython-312.pyc | Bin 0 -> 8984 bytes .../testing/__pycache__/util.cpython-312.pyc | Bin 0 -> 21793 bytes .../__pycache__/warnings.cpython-312.pyc | Bin 0 -> 2027 bytes .../sqlalchemy/testing/assertions.py | 989 ++ .../sqlalchemy/testing/assertsql.py | 516 + .../sqlalchemy/testing/asyncio.py | 135 + .../sqlalchemy/testing/config.py | 423 + .../sqlalchemy/testing/engines.py | 474 + .../sqlalchemy/testing/entities.py | 117 + .../sqlalchemy/testing/exclusions.py | 435 + .../sqlalchemy/testing/fixtures/__init__.py | 28 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 934 bytes .../fixtures/__pycache__/base.cpython-312.pyc | Bin 0 -> 13277 bytes .../fixtures/__pycache__/mypy.cpython-312.pyc | Bin 0 -> 12827 bytes .../fixtures/__pycache__/orm.cpython-312.pyc | Bin 0 -> 11473 bytes .../fixtures/__pycache__/sql.cpython-312.pyc | Bin 0 -> 22426 bytes .../sqlalchemy/testing/fixtures/base.py | 366 + .../sqlalchemy/testing/fixtures/mypy.py | 312 + .../sqlalchemy/testing/fixtures/orm.py | 227 + .../sqlalchemy/testing/fixtures/sql.py | 503 + .../sqlalchemy/testing/pickleable.py | 155 + .../sqlalchemy/testing/plugin/__init__.py | 6 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 223 bytes .../__pycache__/bootstrap.cpython-312.pyc | Bin 0 -> 2174 bytes .../__pycache__/plugin_base.cpython-312.pyc | Bin 0 -> 27762 bytes .../__pycache__/pytestplugin.cpython-312.pyc | Bin 0 -> 32833 bytes .../sqlalchemy/testing/plugin/bootstrap.py | 51 + .../sqlalchemy/testing/plugin/plugin_base.py | 779 ++ .../sqlalchemy/testing/plugin/pytestplugin.py | 868 ++ .../sqlalchemy/testing/profiling.py | 324 + .../sqlalchemy/testing/provision.py | 502 + .../sqlalchemy/testing/requirements.py | 1834 ++++ .../sqlalchemy/testing/schema.py | 224 + .../sqlalchemy/testing/suite/__init__.py | 19 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 590 bytes .../__pycache__/test_cte.cpython-312.pyc | Bin 0 -> 9924 bytes .../__pycache__/test_ddl.cpython-312.pyc | Bin 0 -> 18773 bytes .../test_deprecations.cpython-312.pyc | Bin 0 -> 9031 bytes .../__pycache__/test_dialect.cpython-312.pyc | Bin 0 -> 34419 bytes .../__pycache__/test_insert.cpython-312.pyc | Bin 0 -> 25299 bytes .../test_reflection.cpython-312.pyc | Bin 0 -> 141445 bytes .../__pycache__/test_results.cpython-312.pyc | Bin 0 -> 25281 bytes .../__pycache__/test_rowcount.cpython-312.pyc | Bin 0 -> 10374 bytes .../__pycache__/test_select.cpython-312.pyc | Bin 0 -> 114985 bytes .../__pycache__/test_sequence.cpython-312.pyc | Bin 0 -> 15006 bytes .../__pycache__/test_types.cpython-312.pyc | Bin 0 -> 98998 bytes .../test_unicode_ddl.cpython-312.pyc | Bin 0 -> 7644 bytes .../test_update_delete.cpython-312.pyc | Bin 0 -> 7408 bytes .../sqlalchemy/testing/suite/test_cte.py | 211 + .../sqlalchemy/testing/suite/test_ddl.py | 389 + .../testing/suite/test_deprecations.py | 153 + .../sqlalchemy/testing/suite/test_dialect.py | 740 ++ .../sqlalchemy/testing/suite/test_insert.py | 630 ++ .../testing/suite/test_reflection.py | 3229 ++++++ .../sqlalchemy/testing/suite/test_results.py | 502 + .../sqlalchemy/testing/suite/test_rowcount.py | 258 + .../sqlalchemy/testing/suite/test_select.py | 2008 ++++ .../sqlalchemy/testing/suite/test_sequence.py | 317 + .../sqlalchemy/testing/suite/test_types.py | 2145 ++++ .../testing/suite/test_unicode_ddl.py | 189 + .../testing/suite/test_update_delete.py | 139 + .../site-packages/sqlalchemy/testing/util.py | 538 + .../sqlalchemy/testing/warnings.py | 52 + .venv/Lib/site-packages/sqlalchemy/types.py | 76 + .../site-packages/sqlalchemy/util/__init__.py | 160 + .../util/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 5701 bytes .../__pycache__/_collections.cpython-312.pyc | Bin 0 -> 31681 bytes .../_concurrency_py3k.cpython-312.pyc | Bin 0 -> 10869 bytes .../util/__pycache__/_has_cy.cpython-312.pyc | Bin 0 -> 1114 bytes .../_py_collections.cpython-312.pyc | Bin 0 -> 29257 bytes .../util/__pycache__/compat.cpython-312.pyc | Bin 0 -> 12483 bytes .../__pycache__/concurrency.cpython-312.pyc | Bin 0 -> 4066 bytes .../__pycache__/deprecations.cpython-312.pyc | Bin 0 -> 13667 bytes .../__pycache__/langhelpers.cpython-312.pyc | Bin 0 -> 84723 bytes .../__pycache__/preloaded.cpython-312.pyc | Bin 0 -> 5906 bytes .../util/__pycache__/queue.cpython-312.pyc | Bin 0 -> 14594 bytes .../__pycache__/tool_support.cpython-312.pyc | Bin 0 -> 8719 bytes .../__pycache__/topological.cpython-312.pyc | Bin 0 -> 3932 bytes .../util/__pycache__/typing.cpython-312.pyc | Bin 0 -> 24469 bytes .../sqlalchemy/util/_collections.py | 715 ++ .../sqlalchemy/util/_concurrency_py3k.py | 288 + .../site-packages/sqlalchemy/util/_has_cy.py | 40 + .../sqlalchemy/util/_py_collections.py | 541 + .../site-packages/sqlalchemy/util/compat.py | 301 + .../sqlalchemy/util/concurrency.py | 108 + .../sqlalchemy/util/deprecations.py | 401 + .../sqlalchemy/util/langhelpers.py | 2222 +++++ .../sqlalchemy/util/preloaded.py | 150 + .../site-packages/sqlalchemy/util/queue.py | 322 + .../sqlalchemy/util/tool_support.py | 201 + .../sqlalchemy/util/topological.py | 120 + .../site-packages/sqlalchemy/util/typing.py | 689 ++ .../starlette-0.46.1.dist-info/INSTALLER | 1 + .../starlette-0.46.1.dist-info/METADATA | 176 + .../starlette-0.46.1.dist-info/RECORD | 74 + .../starlette-0.46.1.dist-info/WHEEL | 4 + .../licenses/LICENSE.md | 27 + .venv/Lib/site-packages/starlette/__init__.py | 1 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 234 bytes .../_exception_handler.cpython-312.pyc | Bin 0 -> 3106 bytes .../__pycache__/_utils.cpython-312.pyc | Bin 0 -> 5372 bytes .../__pycache__/applications.cpython-312.pyc | Bin 0 -> 13039 bytes .../authentication.cpython-312.pyc | Bin 0 -> 7864 bytes .../__pycache__/background.cpython-312.pyc | Bin 0 -> 2627 bytes .../__pycache__/concurrency.cpython-312.pyc | Bin 0 -> 3261 bytes .../__pycache__/config.cpython-312.pyc | Bin 0 -> 7553 bytes .../__pycache__/convertors.cpython-312.pyc | Bin 0 -> 4804 bytes .../datastructures.cpython-312.pyc | Bin 0 -> 39337 bytes .../__pycache__/endpoints.cpython-312.pyc | Bin 0 -> 7864 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 2418 bytes .../__pycache__/formparsers.cpython-312.pyc | Bin 0 -> 14257 bytes .../__pycache__/requests.cpython-312.pyc | Bin 0 -> 16286 bytes .../__pycache__/responses.cpython-312.pyc | Bin 0 -> 29255 bytes .../__pycache__/routing.cpython-312.pyc | Bin 0 -> 43978 bytes .../__pycache__/schemas.cpython-312.pyc | Bin 0 -> 7063 bytes .../__pycache__/staticfiles.cpython-312.pyc | Bin 0 -> 11618 bytes .../__pycache__/status.cpython-312.pyc | Bin 0 -> 3661 bytes .../__pycache__/templating.cpython-312.pyc | Bin 0 -> 10055 bytes .../__pycache__/testclient.cpython-312.pyc | Bin 0 -> 33324 bytes .../__pycache__/types.cpython-312.pyc | Bin 0 -> 1808 bytes .../__pycache__/websockets.cpython-312.pyc | Bin 0 -> 11840 bytes .../starlette/_exception_handler.py | 65 + .venv/Lib/site-packages/starlette/_utils.py | 100 + .../site-packages/starlette/applications.py | 249 + .../site-packages/starlette/authentication.py | 147 + .../Lib/site-packages/starlette/background.py | 41 + .../site-packages/starlette/concurrency.py | 62 + .venv/Lib/site-packages/starlette/config.py | 138 + .../Lib/site-packages/starlette/convertors.py | 89 + .../site-packages/starlette/datastructures.py | 674 ++ .../Lib/site-packages/starlette/endpoints.py | 122 + .../Lib/site-packages/starlette/exceptions.py | 33 + .../site-packages/starlette/formparsers.py | 275 + .../starlette/middleware/__init__.py | 42 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2570 bytes .../authentication.cpython-312.pyc | Bin 0 -> 2895 bytes .../__pycache__/base.cpython-312.pyc | Bin 0 -> 11191 bytes .../__pycache__/cors.cpython-312.pyc | Bin 0 -> 7456 bytes .../__pycache__/errors.cpython-312.pyc | Bin 0 -> 9986 bytes .../__pycache__/exceptions.cpython-312.pyc | Bin 0 -> 4108 bytes .../__pycache__/gzip.cpython-312.pyc | Bin 0 -> 8565 bytes .../__pycache__/httpsredirect.cpython-312.pyc | Bin 0 -> 1793 bytes .../__pycache__/sessions.cpython-312.pyc | Bin 0 -> 4673 bytes .../__pycache__/trustedhost.cpython-312.pyc | Bin 0 -> 3136 bytes .../__pycache__/wsgi.cpython-312.pyc | Bin 0 -> 8523 bytes .../starlette/middleware/authentication.py | 52 + .../starlette/middleware/base.py | 220 + .../starlette/middleware/cors.py | 172 + .../starlette/middleware/errors.py | 260 + .../starlette/middleware/exceptions.py | 72 + .../starlette/middleware/gzip.py | 141 + .../starlette/middleware/httpsredirect.py | 19 + .../starlette/middleware/sessions.py | 85 + .../starlette/middleware/trustedhost.py | 60 + .../starlette/middleware/wsgi.py | 152 + .venv/Lib/site-packages/starlette/py.typed | 0 .venv/Lib/site-packages/starlette/requests.py | 322 + .../Lib/site-packages/starlette/responses.py | 536 + .venv/Lib/site-packages/starlette/routing.py | 874 ++ .venv/Lib/site-packages/starlette/schemas.py | 147 + .../site-packages/starlette/staticfiles.py | 220 + .venv/Lib/site-packages/starlette/status.py | 95 + .../Lib/site-packages/starlette/templating.py | 216 + .../Lib/site-packages/starlette/testclient.py | 731 ++ .venv/Lib/site-packages/starlette/types.py | 24 + .../Lib/site-packages/starlette/websockets.py | 195 + .../INSTALLER | 1 + .../LICENSE | 279 + .../METADATA | 67 + .../typing_extensions-4.12.2.dist-info/RECORD | 7 + .../typing_extensions-4.12.2.dist-info/WHEEL | 4 + .venv/Lib/site-packages/typing_extensions.py | 3641 +++++++ .../uvicorn-0.34.0.dist-info/INSTALLER | 1 + .../uvicorn-0.34.0.dist-info/METADATA | 185 + .../uvicorn-0.34.0.dist-info/RECORD | 85 + .../uvicorn-0.34.0.dist-info/REQUESTED | 0 .../uvicorn-0.34.0.dist-info/WHEEL | 4 + .../uvicorn-0.34.0.dist-info/entry_points.txt | 2 + .../licenses/LICENSE.md | 27 + .venv/Lib/site-packages/uvicorn/__init__.py | 5 + .venv/Lib/site-packages/uvicorn/__main__.py | 4 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 403 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 323 bytes .../__pycache__/_subprocess.cpython-312.pyc | Bin 0 -> 2957 bytes .../__pycache__/_types.cpython-312.pyc | Bin 0 -> 11373 bytes .../__pycache__/config.cpython-312.pyc | Bin 0 -> 24748 bytes .../__pycache__/importer.cpython-312.pyc | Bin 0 -> 1796 bytes .../__pycache__/logging.cpython-312.pyc | Bin 0 -> 7805 bytes .../uvicorn/__pycache__/main.cpython-312.pyc | Bin 0 -> 19994 bytes .../__pycache__/server.cpython-312.pyc | Bin 0 -> 16522 bytes .../__pycache__/workers.cpython-312.pyc | Bin 0 -> 6740 bytes .../Lib/site-packages/uvicorn/_subprocess.py | 84 + .venv/Lib/site-packages/uvicorn/_types.py | 281 + .venv/Lib/site-packages/uvicorn/config.py | 530 + .venv/Lib/site-packages/uvicorn/importer.py | 34 + .../uvicorn/lifespan/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 214 bytes .../lifespan/__pycache__/off.cpython-312.pyc | Bin 0 -> 1003 bytes .../lifespan/__pycache__/on.cpython-312.pyc | Bin 0 -> 7978 bytes .../Lib/site-packages/uvicorn/lifespan/off.py | 17 + .../Lib/site-packages/uvicorn/lifespan/on.py | 137 + .venv/Lib/site-packages/uvicorn/logging.py | 117 + .../site-packages/uvicorn/loops/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 211 bytes .../loops/__pycache__/asyncio.cpython-312.pyc | Bin 0 -> 774 bytes .../loops/__pycache__/auto.cpython-312.pyc | Bin 0 -> 678 bytes .../loops/__pycache__/uvloop.cpython-312.pyc | Bin 0 -> 564 bytes .../site-packages/uvicorn/loops/asyncio.py | 10 + .venv/Lib/site-packages/uvicorn/loops/auto.py | 11 + .../Lib/site-packages/uvicorn/loops/uvloop.py | 7 + .venv/Lib/site-packages/uvicorn/main.py | 591 ++ .../uvicorn/middleware/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 216 bytes .../__pycache__/asgi2.cpython-312.pyc | Bin 0 -> 1026 bytes .../message_logger.cpython-312.pyc | Bin 0 -> 4417 bytes .../__pycache__/proxy_headers.cpython-312.pyc | Bin 0 -> 5836 bytes .../__pycache__/wsgi.cpython-312.pyc | Bin 0 -> 9959 bytes .../site-packages/uvicorn/middleware/asgi2.py | 15 + .../uvicorn/middleware/message_logger.py | 87 + .../uvicorn/middleware/proxy_headers.py | 142 + .../site-packages/uvicorn/middleware/wsgi.py | 200 + .../uvicorn/protocols/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 215 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 2982 bytes .../uvicorn/protocols/http/__init__.py | 0 .../http/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 220 bytes .../http/__pycache__/auto.cpython-312.pyc | Bin 0 -> 631 bytes .../__pycache__/flow_control.cpython-312.pyc | Bin 0 -> 3061 bytes .../http/__pycache__/h11_impl.cpython-312.pyc | Bin 0 -> 27051 bytes .../httptools_impl.cpython-312.pyc | Bin 0 -> 29052 bytes .../uvicorn/protocols/http/auto.py | 15 + .../uvicorn/protocols/http/flow_control.py | 54 + .../uvicorn/protocols/http/h11_impl.py | 543 ++ .../uvicorn/protocols/http/httptools_impl.py | 570 ++ .../site-packages/uvicorn/protocols/utils.py | 56 + .../uvicorn/protocols/websockets/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 226 bytes .../__pycache__/auto.cpython-312.pyc | Bin 0 -> 811 bytes .../websockets_impl.cpython-312.pyc | Bin 0 -> 20505 bytes .../__pycache__/wsproto_impl.cpython-312.pyc | Bin 0 -> 21169 bytes .../uvicorn/protocols/websockets/auto.py | 21 + .../protocols/websockets/websockets_impl.py | 386 + .../protocols/websockets/wsproto_impl.py | 377 + .venv/Lib/site-packages/uvicorn/py.typed | 1 + .venv/Lib/site-packages/uvicorn/server.py | 337 + .../uvicorn/supervisors/__init__.py | 16 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 780 bytes .../__pycache__/basereload.cpython-312.pyc | Bin 0 -> 6890 bytes .../__pycache__/multiprocess.cpython-312.pyc | Bin 0 -> 13347 bytes .../__pycache__/statreload.cpython-312.pyc | Bin 0 -> 2867 bytes .../watchfilesreload.cpython-312.pyc | Bin 0 -> 4558 bytes .../uvicorn/supervisors/basereload.py | 122 + .../uvicorn/supervisors/multiprocess.py | 222 + .../uvicorn/supervisors/statreload.py | 53 + .../uvicorn/supervisors/watchfilesreload.py | 88 + .venv/Lib/site-packages/uvicorn/workers.py | 114 + .../win32_setctime-1.2.0.dist-info/INSTALLER | 1 + .../win32_setctime-1.2.0.dist-info/LICENSE | 21 + .../win32_setctime-1.2.0.dist-info/METADATA | 57 + .../win32_setctime-1.2.0.dist-info/RECORD | 11 + .../win32_setctime-1.2.0.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../site-packages/win32_setctime/__init__.py | 4 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 343 bytes .../__pycache__/_setctime.cpython-312.pyc | Bin 0 -> 3567 bytes .../site-packages/win32_setctime/_setctime.py | 78 + .../Lib/site-packages/win32_setctime/py.typed | 0 .venv/Scripts/Activate.ps1 | 528 + .venv/Scripts/activate | 71 + .venv/Scripts/activate.bat | 34 + .venv/Scripts/deactivate.bat | 22 + .venv/Scripts/fastapi.exe | Bin 0 -> 108435 bytes .venv/Scripts/pip.exe | Bin 0 -> 108446 bytes .venv/Scripts/pip3.12.exe | Bin 0 -> 108446 bytes .venv/Scripts/pip3.exe | Bin 0 -> 108446 bytes .venv/Scripts/python.exe | Bin 0 -> 275176 bytes .venv/Scripts/pythonw.exe | Bin 0 -> 263528 bytes .venv/Scripts/uvicorn.exe | Bin 0 -> 108436 bytes .venv/pyvenv.cfg | 5 + __pycache__/main.cpython-312.pyc | Bin 0 -> 1066 bytes app/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 177 bytes app/api/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 181 bytes .../core/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 186 bytes .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 197 bytes .../activity_tracker.cpython-312.pyc | Bin 0 -> 1179 bytes app/api/core/middleware/activity_tracker.py | 8 +- .../db/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 184 bytes .../db/__pycache__/database.cpython-312.pyc | Bin 0 -> 612 bytes .../v1/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 184 bytes app/api/v1/models/posts.py | 11 +- app/api/v1/models/tags.py | 6 +- app/api/v1/models/user.py | 18 +- .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 264 bytes app/api/v1/schemas/comments.py | 6 +- app/api/v1/schemas/posts.py | 2 +- app/api/v1/schemas/tags.py | 8 +- blog_app.db | 0 2335 files changed, 526101 insertions(+), 31 deletions(-) create mode 100644 .venv/Include/site/python3.12/greenlet/greenlet.h create mode 100644 .venv/Lib/site-packages/__pycache__/typing_extensions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE create mode 100644 .venv/Lib/site-packages/annotated_types/__init__.py create mode 100644 .venv/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/annotated_types/__pycache__/test_cases.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/annotated_types/py.typed create mode 100644 .venv/Lib/site-packages/annotated_types/test_cases.py create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/LICENSE create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/entry_points.txt create mode 100644 .venv/Lib/site-packages/anyio-4.9.0.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/anyio/__init__.py create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/from_thread.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/lowlevel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/pytest_plugin.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/to_interpreter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/to_process.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/__pycache__/to_thread.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_backends/__init__.py create mode 100644 .venv/Lib/site-packages/anyio/_backends/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_backends/__pycache__/_asyncio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_backends/__pycache__/_trio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_backends/_asyncio.py create mode 100644 .venv/Lib/site-packages/anyio/_backends/_trio.py create mode 100644 .venv/Lib/site-packages/anyio/_core/__init__.py create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_asyncio_selector_thread.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_eventloop.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_fileio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_resources.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_signals.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_sockets.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_streams.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_subprocesses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_synchronization.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_tasks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_tempfile.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_testing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/__pycache__/_typedattr.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/_core/_asyncio_selector_thread.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_eventloop.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_exceptions.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_fileio.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_resources.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_signals.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_sockets.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_streams.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_subprocesses.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_synchronization.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_tasks.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_tempfile.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_testing.py create mode 100644 .venv/Lib/site-packages/anyio/_core/_typedattr.py create mode 100644 .venv/Lib/site-packages/anyio/abc/__init__.py create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_eventloop.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_resources.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_sockets.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_streams.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_subprocesses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_tasks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/__pycache__/_testing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/abc/_eventloop.py create mode 100644 .venv/Lib/site-packages/anyio/abc/_resources.py create mode 100644 .venv/Lib/site-packages/anyio/abc/_sockets.py create mode 100644 .venv/Lib/site-packages/anyio/abc/_streams.py create mode 100644 .venv/Lib/site-packages/anyio/abc/_subprocesses.py create mode 100644 .venv/Lib/site-packages/anyio/abc/_tasks.py create mode 100644 .venv/Lib/site-packages/anyio/abc/_testing.py create mode 100644 .venv/Lib/site-packages/anyio/from_thread.py create mode 100644 .venv/Lib/site-packages/anyio/lowlevel.py create mode 100644 .venv/Lib/site-packages/anyio/py.typed create mode 100644 .venv/Lib/site-packages/anyio/pytest_plugin.py create mode 100644 .venv/Lib/site-packages/anyio/streams/__init__.py create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/buffered.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/file.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/memory.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/stapled.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/text.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/__pycache__/tls.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/anyio/streams/buffered.py create mode 100644 .venv/Lib/site-packages/anyio/streams/file.py create mode 100644 .venv/Lib/site-packages/anyio/streams/memory.py create mode 100644 .venv/Lib/site-packages/anyio/streams/stapled.py create mode 100644 .venv/Lib/site-packages/anyio/streams/text.py create mode 100644 .venv/Lib/site-packages/anyio/streams/tls.py create mode 100644 .venv/Lib/site-packages/anyio/to_interpreter.py create mode 100644 .venv/Lib/site-packages/anyio/to_process.py create mode 100644 .venv/Lib/site-packages/anyio/to_thread.py create mode 100644 .venv/Lib/site-packages/click-8.1.8.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/click-8.1.8.dist-info/LICENSE.txt create mode 100644 .venv/Lib/site-packages/click-8.1.8.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/click-8.1.8.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/click-8.1.8.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/click/__init__.py create mode 100644 .venv/Lib/site-packages/click/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/_compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/_termui_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/_textwrap.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/_winconsole.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/core.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/decorators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/formatting.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/globals.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/parser.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/shell_completion.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/termui.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/testing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/click/_compat.py create mode 100644 .venv/Lib/site-packages/click/_termui_impl.py create mode 100644 .venv/Lib/site-packages/click/_textwrap.py create mode 100644 .venv/Lib/site-packages/click/_winconsole.py create mode 100644 .venv/Lib/site-packages/click/core.py create mode 100644 .venv/Lib/site-packages/click/decorators.py create mode 100644 .venv/Lib/site-packages/click/exceptions.py create mode 100644 .venv/Lib/site-packages/click/formatting.py create mode 100644 .venv/Lib/site-packages/click/globals.py create mode 100644 .venv/Lib/site-packages/click/parser.py create mode 100644 .venv/Lib/site-packages/click/py.typed create mode 100644 .venv/Lib/site-packages/click/shell_completion.py create mode 100644 .venv/Lib/site-packages/click/termui.py create mode 100644 .venv/Lib/site-packages/click/testing.py create mode 100644 .venv/Lib/site-packages/click/types.py create mode 100644 .venv/Lib/site-packages/click/utils.py create mode 100644 .venv/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/colorama-0.4.6.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/colorama-0.4.6.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt create mode 100644 .venv/Lib/site-packages/colorama/__init__.py create mode 100644 .venv/Lib/site-packages/colorama/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/__pycache__/ansi.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/__pycache__/ansitowin32.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/__pycache__/initialise.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/__pycache__/win32.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/__pycache__/winterm.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/ansi.py create mode 100644 .venv/Lib/site-packages/colorama/ansitowin32.py create mode 100644 .venv/Lib/site-packages/colorama/initialise.py create mode 100644 .venv/Lib/site-packages/colorama/tests/__init__.py create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/ansi_test.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/ansitowin32_test.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/initialise_test.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/isatty_test.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/__pycache__/winterm_test.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/colorama/tests/ansi_test.py create mode 100644 .venv/Lib/site-packages/colorama/tests/ansitowin32_test.py create mode 100644 .venv/Lib/site-packages/colorama/tests/initialise_test.py create mode 100644 .venv/Lib/site-packages/colorama/tests/isatty_test.py create mode 100644 .venv/Lib/site-packages/colorama/tests/utils.py create mode 100644 .venv/Lib/site-packages/colorama/tests/winterm_test.py create mode 100644 .venv/Lib/site-packages/colorama/win32.py create mode 100644 .venv/Lib/site-packages/colorama/winterm.py create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/REQUESTED create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/entry_points.txt create mode 100644 .venv/Lib/site-packages/fastapi-0.115.11.dist-info/licenses/LICENSE create mode 100644 .venv/Lib/site-packages/fastapi/__init__.py create mode 100644 .venv/Lib/site-packages/fastapi/__main__.py create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/_compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/applications.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/background.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/cli.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/concurrency.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/datastructures.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/encoders.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/exception_handlers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/logger.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/param_functions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/params.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/requests.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/responses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/routing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/staticfiles.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/templating.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/testclient.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/__pycache__/websockets.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/_compat.py create mode 100644 .venv/Lib/site-packages/fastapi/applications.py create mode 100644 .venv/Lib/site-packages/fastapi/background.py create mode 100644 .venv/Lib/site-packages/fastapi/cli.py create mode 100644 .venv/Lib/site-packages/fastapi/concurrency.py create mode 100644 .venv/Lib/site-packages/fastapi/datastructures.py create mode 100644 .venv/Lib/site-packages/fastapi/dependencies/__init__.py create mode 100644 .venv/Lib/site-packages/fastapi/dependencies/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/dependencies/__pycache__/models.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/dependencies/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/dependencies/models.py create mode 100644 .venv/Lib/site-packages/fastapi/dependencies/utils.py create mode 100644 .venv/Lib/site-packages/fastapi/encoders.py create mode 100644 .venv/Lib/site-packages/fastapi/exception_handlers.py create mode 100644 .venv/Lib/site-packages/fastapi/exceptions.py create mode 100644 .venv/Lib/site-packages/fastapi/logger.py create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__init__.py create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__pycache__/cors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__pycache__/gzip.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__pycache__/httpsredirect.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__pycache__/trustedhost.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/middleware/__pycache__/wsgi.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/middleware/cors.py create mode 100644 .venv/Lib/site-packages/fastapi/middleware/gzip.py create mode 100644 .venv/Lib/site-packages/fastapi/middleware/httpsredirect.py create mode 100644 .venv/Lib/site-packages/fastapi/middleware/trustedhost.py create mode 100644 .venv/Lib/site-packages/fastapi/middleware/wsgi.py create mode 100644 .venv/Lib/site-packages/fastapi/openapi/__init__.py create mode 100644 .venv/Lib/site-packages/fastapi/openapi/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/openapi/__pycache__/constants.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/openapi/__pycache__/docs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/openapi/__pycache__/models.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/openapi/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/openapi/constants.py create mode 100644 .venv/Lib/site-packages/fastapi/openapi/docs.py create mode 100644 .venv/Lib/site-packages/fastapi/openapi/models.py create mode 100644 .venv/Lib/site-packages/fastapi/openapi/utils.py create mode 100644 .venv/Lib/site-packages/fastapi/param_functions.py create mode 100644 .venv/Lib/site-packages/fastapi/params.py create mode 100644 .venv/Lib/site-packages/fastapi/py.typed create mode 100644 .venv/Lib/site-packages/fastapi/requests.py create mode 100644 .venv/Lib/site-packages/fastapi/responses.py create mode 100644 .venv/Lib/site-packages/fastapi/routing.py create mode 100644 .venv/Lib/site-packages/fastapi/security/__init__.py create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/api_key.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/http.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/oauth2.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/open_id_connect_url.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/fastapi/security/api_key.py create mode 100644 .venv/Lib/site-packages/fastapi/security/base.py create mode 100644 .venv/Lib/site-packages/fastapi/security/http.py create mode 100644 .venv/Lib/site-packages/fastapi/security/oauth2.py create mode 100644 .venv/Lib/site-packages/fastapi/security/open_id_connect_url.py create mode 100644 .venv/Lib/site-packages/fastapi/security/utils.py create mode 100644 .venv/Lib/site-packages/fastapi/staticfiles.py create mode 100644 .venv/Lib/site-packages/fastapi/templating.py create mode 100644 .venv/Lib/site-packages/fastapi/testclient.py create mode 100644 .venv/Lib/site-packages/fastapi/types.py create mode 100644 .venv/Lib/site-packages/fastapi/utils.py create mode 100644 .venv/Lib/site-packages/fastapi/websockets.py create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/AUTHORS create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE.PSF create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/greenlet-3.1.1.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/greenlet/CObjects.cpp create mode 100644 .venv/Lib/site-packages/greenlet/PyGreenlet.cpp create mode 100644 .venv/Lib/site-packages/greenlet/PyGreenlet.hpp create mode 100644 .venv/Lib/site-packages/greenlet/PyGreenletUnswitchable.cpp create mode 100644 .venv/Lib/site-packages/greenlet/PyModule.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TBrokenGreenlet.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TExceptionState.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TGreenlet.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TGreenlet.hpp create mode 100644 .venv/Lib/site-packages/greenlet/TGreenletGlobals.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TMainGreenlet.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TPythonState.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TStackState.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TThreadState.hpp create mode 100644 .venv/Lib/site-packages/greenlet/TThreadStateCreator.hpp create mode 100644 .venv/Lib/site-packages/greenlet/TThreadStateDestroy.cpp create mode 100644 .venv/Lib/site-packages/greenlet/TUserGreenlet.cpp create mode 100644 .venv/Lib/site-packages/greenlet/__init__.py create mode 100644 .venv/Lib/site-packages/greenlet/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/_greenlet.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/greenlet/greenlet.cpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet.h create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_allocator.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_exceptions.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_internal.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_refs.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_slp_switch.hpp create mode 100644 .venv/Lib/site-packages/greenlet/greenlet_thread_support.hpp create mode 100644 .venv/Lib/site-packages/greenlet/platform/__init__.py create mode 100644 .venv/Lib/site-packages/greenlet/platform/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_alpha_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_amd64_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_arm32_ios.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.obj create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_csky_gcc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_mips_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_ppc_aix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_ppc_linux.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_ppc_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_riscv_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_s390_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_sh_gcc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_x32_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_x64_masm.asm create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_x64_masm.obj create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_x64_msvc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_x86_msvc.h create mode 100644 .venv/Lib/site-packages/greenlet/platform/switch_x86_unix.h create mode 100644 .venv/Lib/site-packages/greenlet/slp_platformselect.h create mode 100644 .venv/Lib/site-packages/greenlet/tests/__init__.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_cpp_exception.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_slp_switch.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/leakcheck.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_contextvars.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_cpp.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_extension_interface.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_gc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_generator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_generator_nested.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet_trash.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_leaks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_stack_saved.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_throw.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_tracing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/__pycache__/test_weakref.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/greenlet/tests/_test_extension.c create mode 100644 .venv/Lib/site-packages/greenlet/tests/_test_extension.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/greenlet/tests/_test_extension_cpp.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/greenlet/tests/_test_extension_cpp.cpp create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_cpp_exception.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_slp_switch.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/leakcheck.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_contextvars.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_cpp.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_extension_interface.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_gc.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_generator.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_generator_nested.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_greenlet.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_greenlet_trash.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_leaks.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_stack_saved.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_throw.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_tracing.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_version.py create mode 100644 .venv/Lib/site-packages/greenlet/tests/test_weakref.py create mode 100644 .venv/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt create mode 100644 .venv/Lib/site-packages/h11-0.14.0.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/h11-0.14.0.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/h11-0.14.0.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/h11/__init__.py create mode 100644 .venv/Lib/site-packages/h11/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_abnf.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_connection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_headers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_readers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_receivebuffer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_state.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/__pycache__/_writers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/_abnf.py create mode 100644 .venv/Lib/site-packages/h11/_connection.py create mode 100644 .venv/Lib/site-packages/h11/_events.py create mode 100644 .venv/Lib/site-packages/h11/_headers.py create mode 100644 .venv/Lib/site-packages/h11/_readers.py create mode 100644 .venv/Lib/site-packages/h11/_receivebuffer.py create mode 100644 .venv/Lib/site-packages/h11/_state.py create mode 100644 .venv/Lib/site-packages/h11/_util.py create mode 100644 .venv/Lib/site-packages/h11/_version.py create mode 100644 .venv/Lib/site-packages/h11/_writers.py create mode 100644 .venv/Lib/site-packages/h11/py.typed create mode 100644 .venv/Lib/site-packages/h11/tests/__init__.py create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/helpers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_against_stdlib_http.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_connection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_headers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_helpers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_io.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_receivebuffer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_state.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/__pycache__/test_util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/h11/tests/data/test-file create mode 100644 .venv/Lib/site-packages/h11/tests/helpers.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_against_stdlib_http.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_connection.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_events.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_headers.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_helpers.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_io.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_receivebuffer.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_state.py create mode 100644 .venv/Lib/site-packages/h11/tests/test_util.py create mode 100644 .venv/Lib/site-packages/idna-3.10.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/idna-3.10.dist-info/LICENSE.md create mode 100644 .venv/Lib/site-packages/idna-3.10.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/idna-3.10.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/idna-3.10.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/idna/__init__.py create mode 100644 .venv/Lib/site-packages/idna/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/codec.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/core.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/idnadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/intranges.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/package_data.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/__pycache__/uts46data.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/idna/codec.py create mode 100644 .venv/Lib/site-packages/idna/compat.py create mode 100644 .venv/Lib/site-packages/idna/core.py create mode 100644 .venv/Lib/site-packages/idna/idnadata.py create mode 100644 .venv/Lib/site-packages/idna/intranges.py create mode 100644 .venv/Lib/site-packages/idna/package_data.py create mode 100644 .venv/Lib/site-packages/idna/py.typed create mode 100644 .venv/Lib/site-packages/idna/uts46data.py create mode 100644 .venv/Lib/site-packages/loguru-0.7.3.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/loguru-0.7.3.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/loguru-0.7.3.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/loguru-0.7.3.dist-info/REQUESTED create mode 100644 .venv/Lib/site-packages/loguru-0.7.3.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/loguru/__init__.py create mode 100644 .venv/Lib/site-packages/loguru/__init__.pyi create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_asyncio_loop.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_better_exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_colorama.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_colorizer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_contextvars.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_ctime_functions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_datetime.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_defaults.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_error_interceptor.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_file_sink.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_filters.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_get_frame.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_handler.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_locks_machinery.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_logger.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_recattrs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_simple_sinks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/__pycache__/_string_parsers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/loguru/_asyncio_loop.py create mode 100644 .venv/Lib/site-packages/loguru/_better_exceptions.py create mode 100644 .venv/Lib/site-packages/loguru/_colorama.py create mode 100644 .venv/Lib/site-packages/loguru/_colorizer.py create mode 100644 .venv/Lib/site-packages/loguru/_contextvars.py create mode 100644 .venv/Lib/site-packages/loguru/_ctime_functions.py create mode 100644 .venv/Lib/site-packages/loguru/_datetime.py create mode 100644 .venv/Lib/site-packages/loguru/_defaults.py create mode 100644 .venv/Lib/site-packages/loguru/_error_interceptor.py create mode 100644 .venv/Lib/site-packages/loguru/_file_sink.py create mode 100644 .venv/Lib/site-packages/loguru/_filters.py create mode 100644 .venv/Lib/site-packages/loguru/_get_frame.py create mode 100644 .venv/Lib/site-packages/loguru/_handler.py create mode 100644 .venv/Lib/site-packages/loguru/_locks_machinery.py create mode 100644 .venv/Lib/site-packages/loguru/_logger.py create mode 100644 .venv/Lib/site-packages/loguru/_recattrs.py create mode 100644 .venv/Lib/site-packages/loguru/_simple_sinks.py create mode 100644 .venv/Lib/site-packages/loguru/_string_parsers.py create mode 100644 .venv/Lib/site-packages/loguru/py.typed create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/AUTHORS.txt create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/LICENSE.txt create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/REQUESTED create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/entry_points.txt create mode 100644 .venv/Lib/site-packages/pip-24.3.1.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/pip/__init__.py create mode 100644 .venv/Lib/site-packages/pip/__main__.py create mode 100644 .venv/Lib/site-packages/pip/__pip-runner__.py create mode 100644 .venv/Lib/site-packages/pip/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/__pycache__/__pip-runner__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/build_env.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/configuration.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/main.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/pyproject.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/__pycache__/wheel_builder.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/build_env.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cache.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/base_command.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/command_context.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/index_command.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/main.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/parser.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/progress_bars.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/req_command.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/spinners.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/autocompletion.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/base_command.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/cmdoptions.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/command_context.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/index_command.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/main.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/main_parser.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/parser.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/progress_bars.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/req_command.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/spinners.py create mode 100644 .venv/Lib/site-packages/pip/_internal/cli/status_codes.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/check.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/completion.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/configuration.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/debug.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/download.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/freeze.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/hash.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/help.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/index.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/inspect.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/install.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/list.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/search.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/show.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/cache.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/check.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/completion.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/configuration.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/debug.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/download.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/freeze.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/hash.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/help.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/index.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/inspect.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/install.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/list.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/search.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/show.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/uninstall.py create mode 100644 .venv/Lib/site-packages/pip/_internal/commands/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/configuration.py create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/__pycache__/installed.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/__pycache__/sdist.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/base.py create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/installed.py create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/sdist.py create mode 100644 .venv/Lib/site-packages/pip/_internal/distributions/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/exceptions.py create mode 100644 .venv/Lib/site-packages/pip/_internal/index/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/index/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/index/__pycache__/collector.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/index/__pycache__/package_finder.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/index/__pycache__/sources.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/index/collector.py create mode 100644 .venv/Lib/site-packages/pip/_internal/index/package_finder.py create mode 100644 .venv/Lib/site-packages/pip/_internal/index/sources.py create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/__pycache__/_distutils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/__pycache__/_sysconfig.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/_distutils.py create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/_sysconfig.py create mode 100644 .venv/Lib/site-packages/pip/_internal/locations/base.py create mode 100644 .venv/Lib/site-packages/pip/_internal/main.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/__pycache__/_json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/__pycache__/pkg_resources.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/_json.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/base.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/__pycache__/_compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/__pycache__/_dists.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/__pycache__/_envs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/_compat.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/_dists.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/importlib/_envs.py create mode 100644 .venv/Lib/site-packages/pip/_internal/metadata/pkg_resources.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/candidate.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/direct_url.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/format_control.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/index.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/installation_report.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/link.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/scheme.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/search_scope.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/target_python.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/models/candidate.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/direct_url.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/format_control.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/index.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/installation_report.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/link.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/scheme.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/search_scope.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/selection_prefs.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/target_python.py create mode 100644 .venv/Lib/site-packages/pip/_internal/models/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/auth.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/download.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/lazy_wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/session.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/network/auth.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/cache.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/download.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/lazy_wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/session.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/utils.py create mode 100644 .venv/Lib/site-packages/pip/_internal/network/xmlrpc.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/__pycache__/check.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/__pycache__/freeze.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/__pycache__/prepare.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/build_tracker.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/metadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/metadata_editable.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/metadata_legacy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/wheel_editable.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/__pycache__/wheel_legacy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/build_tracker.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/metadata.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/metadata_editable.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/metadata_legacy.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/wheel_editable.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/build/wheel_legacy.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/check.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/freeze.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/install/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/install/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/install/__pycache__/editable_legacy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/install/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/install/editable_legacy.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/install/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/operations/prepare.py create mode 100644 .venv/Lib/site-packages/pip/_internal/pyproject.py create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__pycache__/constructors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__pycache__/req_file.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__pycache__/req_install.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__pycache__/req_set.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/req/constructors.py create mode 100644 .venv/Lib/site-packages/pip/_internal/req/req_file.py create mode 100644 .venv/Lib/site-packages/pip/_internal/req/req_install.py create mode 100644 .venv/Lib/site-packages/pip/_internal/req/req_set.py create mode 100644 .venv/Lib/site-packages/pip/_internal/req/req_uninstall.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/base.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/legacy/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/legacy/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/legacy/__pycache__/resolver.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/legacy/resolver.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/candidates.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/factory.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/found_candidates.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/provider.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/reporter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/requirements.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/__pycache__/resolver.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/base.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/candidates.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/factory.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/provider.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/reporter.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/requirements.py create mode 100644 .venv/Lib/site-packages/pip/_internal/resolution/resolvelib/resolver.py create mode 100644 .venv/Lib/site-packages/pip/_internal/self_outdated_check.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/_jaraco_text.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/_log.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/compatibility_tags.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/datetime.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/direct_url_helpers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/egg_link.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/encoding.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/entrypoints.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/glibc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/hashes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/logging.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/misc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/packaging.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/retry.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/urls.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/_jaraco_text.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/_log.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/appdirs.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/compat.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/compatibility_tags.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/datetime.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/deprecation.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/direct_url_helpers.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/egg_link.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/encoding.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/entrypoints.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/filesystem.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/filetypes.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/glibc.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/hashes.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/logging.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/misc.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/packaging.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/retry.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/setuptools_build.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/subprocess.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/temp_dir.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/unpacking.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/urls.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/virtualenv.py create mode 100644 .venv/Lib/site-packages/pip/_internal/utils/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__pycache__/git.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/bazaar.py create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/git.py create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/mercurial.py create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/subversion.py create mode 100644 .venv/Lib/site-packages/pip/_internal/vcs/versioncontrol.py create mode 100644 .venv/Lib/site-packages/pip/_internal/wheel_builder.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/__pycache__/typing_extensions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/_cmd.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/adapter.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/cache.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/caches/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/controller.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/filewrapper.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/heuristics.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/serialize.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/cachecontrol/wrapper.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/__main__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/__pycache__/core.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/cacert.pem create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/core.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/certifi/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/database.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/index.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/compat.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/database.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/index.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/locators.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/manifest.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/markers.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/metadata.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/resources.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/scripts.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/t32.exe create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/t64-arm.exe create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/t64.exe create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/util.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/version.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/w32.exe create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/w64-arm.exe create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/w64.exe create mode 100644 .venv/Lib/site-packages/pip/_vendor/distlib/wheel.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/__main__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/__pycache__/distro.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/distro.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/distro/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/codec.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/core.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/codec.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/compat.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/core.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/idnadata.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/intranges.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/package_data.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/idna/uts46data.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/__pycache__/ext.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/exceptions.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/ext.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/msgpack/fallback.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/_parser.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/metadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/__pycache__/version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/_elffile.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/_manylinux.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/_musllinux.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/_parser.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/_structures.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/_tokenizer.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/markers.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/metadata.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/requirements.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/specifiers.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/tags.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/utils.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/packaging/version.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pkg_resources/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__main__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/android.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/api.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/android.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/api.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/macos.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/unix.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/version.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/platformdirs/windows.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__main__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/cmdline.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/console.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/filter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/formatter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/lexer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/modeline.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/plugin.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/regexopt.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/scanner.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/sphinxext.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/style.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/token.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/unistring.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/cmdline.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/console.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/filter.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/filters/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/filters/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatter.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/_mapping.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/bbcode.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/groff.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/html.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/img.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/irc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/latex.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/other.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/pangomarkup.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/rtf.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/svg.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/__pycache__/terminal256.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/_mapping.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/bbcode.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/groff.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/html.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/img.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/irc.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/latex.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/other.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/pangomarkup.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/rtf.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/svg.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/terminal.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/formatters/terminal256.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexer.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexers/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexers/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexers/__pycache__/_mapping.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexers/__pycache__/python.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexers/_mapping.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/lexers/python.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/modeline.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/plugin.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/regexopt.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/scanner.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/sphinxext.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/style.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/styles/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/styles/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/styles/__pycache__/_mapping.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/styles/_mapping.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/token.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/unistring.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pygments/util.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/__pycache__/_compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/__pycache__/_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/_compat.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/_impl.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/_in_process/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/_in_process/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/_in_process/__pycache__/_in_process.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/__version__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/_internal_utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/adapters.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/api.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/auth.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/certs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/cookies.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/help.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/hooks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/models.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/packages.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/sessions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/status_codes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/structures.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/__version__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/_internal_utils.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/adapters.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/api.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/auth.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/certs.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/compat.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/cookies.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/exceptions.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/help.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/hooks.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/models.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/packages.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/sessions.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/status_codes.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/structures.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/requests/utils.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/__pycache__/providers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/__pycache__/reporters.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/__pycache__/resolvers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/__pycache__/structs.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/compat/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/compat/__pycache__/collections_abc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/compat/collections_abc.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/providers.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/reporters.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/resolvers.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/resolvelib/structs.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__main__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_cell_widths.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_emoji_codes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_emoji_replace.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_export_format.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_extension.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_fileno.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_inspect.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_log_render.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_loop.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_null_file.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_palettes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_pick.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_ratio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_spinners.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_stack.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_timer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_win32_console.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_windows.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_windows_renderer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/_wrap.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/abc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/align.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/ansi.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/bar.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/box.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/cells.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/color.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/color_triplet.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/columns.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/console.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/constrain.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/containers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/control.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/default_styles.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/diagnose.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/emoji.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/errors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/file_proxy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/filesize.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/highlighter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/jupyter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/layout.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/live.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/live_render.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/logging.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/markup.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/measure.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/padding.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/pager.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/palette.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/panel.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/pretty.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/progress.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/progress_bar.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/prompt.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/protocol.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/region.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/repr.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/rule.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/scope.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/screen.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/segment.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/spinner.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/status.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/style.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/styled.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/syntax.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/table.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/terminal_theme.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/text.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/theme.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/themes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/traceback.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/__pycache__/tree.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_cell_widths.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_emoji_codes.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_emoji_replace.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_export_format.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_extension.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_fileno.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_inspect.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_log_render.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_loop.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_null_file.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_palettes.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_pick.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_ratio.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_spinners.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_stack.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_timer.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_win32_console.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_windows.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_windows_renderer.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/_wrap.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/abc.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/align.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/ansi.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/bar.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/box.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/cells.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/color.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/color_triplet.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/columns.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/console.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/constrain.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/containers.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/control.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/default_styles.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/diagnose.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/emoji.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/errors.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/file_proxy.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/filesize.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/highlighter.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/json.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/jupyter.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/layout.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/live.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/live_render.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/logging.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/markup.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/measure.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/padding.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/pager.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/palette.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/panel.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/pretty.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/progress.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/progress_bar.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/prompt.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/protocol.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/region.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/repr.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/rule.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/scope.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/screen.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/segment.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/spinner.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/status.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/style.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/styled.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/syntax.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/table.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/terminal_theme.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/text.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/theme.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/themes.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/traceback.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/rich/tree.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/__pycache__/_parser.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/__pycache__/_re.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/__pycache__/_types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/_parser.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/_re.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/_types.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/tomli/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__pycache__/_api.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__pycache__/_macos.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__pycache__/_openssl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__pycache__/_ssl_constants.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/__pycache__/_windows.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/_api.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/_macos.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/_openssl.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/_ssl_constants.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/_windows.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/truststore/py.typed create mode 100644 .venv/Lib/site-packages/pip/_vendor/typing_extensions.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/_version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/request.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/__pycache__/response.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/_collections.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/_version.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/connection.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/connectionpool.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/appengine.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/securetransport.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/contrib/socks.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/exceptions.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/fields.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/filepost.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/weakref_finalize.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/backports/weakref_finalize.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/packages/six.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/poolmanager.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/request.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/response.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__init__.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/proxy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_match_hostname.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/ssltransport.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/connection.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/proxy.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/queue.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/request.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/response.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/retry.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/ssl_.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/ssl_match_hostname.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/ssltransport.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/timeout.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/url.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/urllib3/util/wait.py create mode 100644 .venv/Lib/site-packages/pip/_vendor/vendor.txt create mode 100644 .venv/Lib/site-packages/pip/py.typed create mode 100644 .venv/Lib/site-packages/pydantic-2.10.6.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/pydantic-2.10.6.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/pydantic-2.10.6.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/pydantic-2.10.6.dist-info/REQUESTED create mode 100644 .venv/Lib/site-packages/pydantic-2.10.6.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/pydantic-2.10.6.dist-info/licenses/LICENSE create mode 100644 .venv/Lib/site-packages/pydantic/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/_migration.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/alias_generators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/aliases.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/annotated_handlers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/class_validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/color.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/dataclasses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/datetime_parse.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/decorator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/env_settings.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/error_wrappers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/errors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/fields.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/functional_serializers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/functional_validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/generics.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/json_schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/main.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/mypy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/networks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/parse.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/root_model.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/tools.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/type_adapter.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/typing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/validate_call_decorator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/__pycache__/warnings.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_core_metadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_core_utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_dataclasses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_decorators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_decorators_v1.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_discriminated_union.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_docs_extraction.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_fields.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_forward_ref.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_generate_schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_generics.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_git.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_import_utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_internal_dataclass.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_known_annotated_metadata.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_mock_val_ser.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_model_construction.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_namespace_utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_repr.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_schema_generation_shared.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_serializers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_signature.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_std_types_schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_typing_extra.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_validate_call.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/__pycache__/_validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_config.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_core_metadata.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_core_utils.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_dataclasses.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_decorators.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_decorators_v1.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_discriminated_union.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_docs_extraction.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_fields.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_forward_ref.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_generate_schema.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_generics.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_git.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_import_utils.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_internal_dataclass.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_known_annotated_metadata.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_mock_val_ser.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_model_construction.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_namespace_utils.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_repr.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_schema_generation_shared.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_serializers.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_signature.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_std_types_schema.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_typing_extra.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_utils.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_validate_call.py create mode 100644 .venv/Lib/site-packages/pydantic/_internal/_validators.py create mode 100644 .venv/Lib/site-packages/pydantic/_migration.py create mode 100644 .venv/Lib/site-packages/pydantic/alias_generators.py create mode 100644 .venv/Lib/site-packages/pydantic/aliases.py create mode 100644 .venv/Lib/site-packages/pydantic/annotated_handlers.py create mode 100644 .venv/Lib/site-packages/pydantic/class_validators.py create mode 100644 .venv/Lib/site-packages/pydantic/color.py create mode 100644 .venv/Lib/site-packages/pydantic/config.py create mode 100644 .venv/Lib/site-packages/pydantic/dataclasses.py create mode 100644 .venv/Lib/site-packages/pydantic/datetime_parse.py create mode 100644 .venv/Lib/site-packages/pydantic/decorator.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/class_validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/copy_internals.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/decorator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/parse.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/__pycache__/tools.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/class_validators.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/config.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/copy_internals.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/decorator.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/json.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/parse.py create mode 100644 .venv/Lib/site-packages/pydantic/deprecated/tools.py create mode 100644 .venv/Lib/site-packages/pydantic/env_settings.py create mode 100644 .venv/Lib/site-packages/pydantic/error_wrappers.py create mode 100644 .venv/Lib/site-packages/pydantic/errors.py create mode 100644 .venv/Lib/site-packages/pydantic/experimental/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic/experimental/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/experimental/__pycache__/pipeline.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/experimental/pipeline.py create mode 100644 .venv/Lib/site-packages/pydantic/fields.py create mode 100644 .venv/Lib/site-packages/pydantic/functional_serializers.py create mode 100644 .venv/Lib/site-packages/pydantic/functional_validators.py create mode 100644 .venv/Lib/site-packages/pydantic/generics.py create mode 100644 .venv/Lib/site-packages/pydantic/json.py create mode 100644 .venv/Lib/site-packages/pydantic/json_schema.py create mode 100644 .venv/Lib/site-packages/pydantic/main.py create mode 100644 .venv/Lib/site-packages/pydantic/mypy.py create mode 100644 .venv/Lib/site-packages/pydantic/networks.py create mode 100644 .venv/Lib/site-packages/pydantic/parse.py create mode 100644 .venv/Lib/site-packages/pydantic/plugin/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic/plugin/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/plugin/__pycache__/_loader.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/plugin/__pycache__/_schema_validator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/plugin/_loader.py create mode 100644 .venv/Lib/site-packages/pydantic/plugin/_schema_validator.py create mode 100644 .venv/Lib/site-packages/pydantic/py.typed create mode 100644 .venv/Lib/site-packages/pydantic/root_model.py create mode 100644 .venv/Lib/site-packages/pydantic/schema.py create mode 100644 .venv/Lib/site-packages/pydantic/tools.py create mode 100644 .venv/Lib/site-packages/pydantic/type_adapter.py create mode 100644 .venv/Lib/site-packages/pydantic/types.py create mode 100644 .venv/Lib/site-packages/pydantic/typing.py create mode 100644 .venv/Lib/site-packages/pydantic/utils.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/_hypothesis_plugin.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/annotated_types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/class_validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/color.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/dataclasses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/datetime_parse.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/decorator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/env_settings.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/error_wrappers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/errors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/fields.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/generics.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/main.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/mypy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/networks.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/parse.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/tools.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/typing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/validators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/__pycache__/version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic/v1/_hypothesis_plugin.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/annotated_types.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/class_validators.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/color.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/config.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/dataclasses.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/datetime_parse.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/decorator.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/env_settings.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/error_wrappers.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/errors.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/fields.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/generics.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/json.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/main.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/mypy.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/networks.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/parse.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/py.typed create mode 100644 .venv/Lib/site-packages/pydantic/v1/schema.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/tools.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/types.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/typing.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/utils.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/validators.py create mode 100644 .venv/Lib/site-packages/pydantic/v1/version.py create mode 100644 .venv/Lib/site-packages/pydantic/validate_call_decorator.py create mode 100644 .venv/Lib/site-packages/pydantic/validators.py create mode 100644 .venv/Lib/site-packages/pydantic/version.py create mode 100644 .venv/Lib/site-packages/pydantic/warnings.py create mode 100644 .venv/Lib/site-packages/pydantic_core-2.27.2.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/pydantic_core-2.27.2.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/pydantic_core-2.27.2.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/pydantic_core-2.27.2.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/pydantic_core-2.27.2.dist-info/licenses/LICENSE create mode 100644 .venv/Lib/site-packages/pydantic_core/__init__.py create mode 100644 .venv/Lib/site-packages/pydantic_core/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic_core/__pycache__/core_schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/pydantic_core/_pydantic_core.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/pydantic_core/_pydantic_core.pyi create mode 100644 .venv/Lib/site-packages/pydantic_core/core_schema.py create mode 100644 .venv/Lib/site-packages/pydantic_core/py.typed create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/LICENSE create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/LICENSE.APACHE2 create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/LICENSE.MIT create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/sniffio-1.3.1.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/sniffio/__init__.py create mode 100644 .venv/Lib/site-packages/sniffio/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sniffio/__pycache__/_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sniffio/__pycache__/_version.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sniffio/_impl.py create mode 100644 .venv/Lib/site-packages/sniffio/_tests/__init__.py create mode 100644 .venv/Lib/site-packages/sniffio/_tests/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sniffio/_tests/__pycache__/test_sniffio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sniffio/_tests/test_sniffio.py create mode 100644 .venv/Lib/site-packages/sniffio/_version.py create mode 100644 .venv/Lib/site-packages/sniffio/py.typed create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/LICENSE create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/REQUESTED create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/sqlalchemy-2.0.39.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/sqlalchemy/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/exc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/inspection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/log.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/__pycache__/aioodbc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/__pycache__/asyncio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/__pycache__/pyodbc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/aioodbc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/asyncio.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/connectors/pyodbc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/collections.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/collections.pyx create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/immutabledict.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/immutabledict.pxd create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/immutabledict.pyx create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/processors.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/processors.pyx create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/resultproxy.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/resultproxy.pyx create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/util.cp312-win_amd64.pyd create mode 100644 .venv/Lib/site-packages/sqlalchemy/cyextension/util.pyx create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/__pycache__/_typing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/_typing.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/aioodbc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/information_schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/provision.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/pymssql.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/__pycache__/pyodbc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/aioodbc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/information_schema.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/json.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/provision.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/pymssql.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mssql/pyodbc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/aiomysql.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/asyncmy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/cymysql.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/dml.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/enumerated.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/expression.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/mariadb.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/mariadbconnector.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/mysqlconnector.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/mysqldb.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/provision.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/pymysql.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/pyodbc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/reflection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/reserved_words.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/aiomysql.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/asyncmy.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/cymysql.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/dml.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/enumerated.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/expression.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/json.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/mariadb.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/mariadbconnector.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/mysqlconnector.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/mysqldb.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/provision.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/pymysql.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/pyodbc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/reflection.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/reserved_words.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/mysql/types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/cx_oracle.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/dictionary.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/oracledb.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/provision.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/cx_oracle.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/dictionary.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/oracledb.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/provision.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/oracle/types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/_psycopg_common.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/array.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/asyncpg.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/dml.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/ext.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/hstore.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/named_types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/operators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/pg8000.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/pg_catalog.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/provision.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/psycopg.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/psycopg2.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/psycopg2cffi.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/ranges.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/_psycopg_common.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/array.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/asyncpg.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/dml.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/ext.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/hstore.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/json.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/named_types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/operators.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/pg8000.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/pg_catalog.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/provision.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/psycopg.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/psycopg2.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/psycopg2cffi.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/ranges.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/postgresql/types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/aiosqlite.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/dml.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/json.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/provision.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/pysqlcipher.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/__pycache__/pysqlite.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/aiosqlite.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/dml.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/json.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/provision.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/pysqlcipher.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/sqlite/pysqlite.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/dialects/type_migration_guidelines.txt create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/_py_processors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/_py_row.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/_py_util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/characteristics.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/create.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/cursor.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/default.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/interfaces.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/mock.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/processors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/reflection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/result.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/row.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/strategies.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/url.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/_py_processors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/_py_row.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/_py_util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/characteristics.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/create.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/cursor.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/default.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/events.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/interfaces.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/mock.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/processors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/reflection.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/result.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/row.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/strategies.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/url.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/engine/util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__pycache__/api.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__pycache__/attr.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__pycache__/legacy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/__pycache__/registry.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/api.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/attr.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/legacy.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/event/registry.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/events.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/exc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/associationproxy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/automap.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/baked.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/compiler.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/horizontal_shard.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/hybrid.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/indexable.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/instrumentation.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/mutable.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/orderinglist.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/__pycache__/serializer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/associationproxy.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/engine.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/exc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/result.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/scoping.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/__pycache__/session.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/engine.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/exc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/result.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/scoping.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/asyncio/session.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/automap.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/baked.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/compiler.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/declarative/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/declarative/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/declarative/__pycache__/extensions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/declarative/extensions.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/horizontal_shard.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/hybrid.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/indexable.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/instrumentation.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mutable.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/apply.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/decl_class.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/infer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/names.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/plugin.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/apply.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/decl_class.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/infer.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/names.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/plugin.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/mypy/util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/orderinglist.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/ext/serializer.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/future/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/future/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/future/__pycache__/engine.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/future/engine.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/inspection.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/log.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/_orm_constructors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/_typing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/attributes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/bulk_persistence.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/clsregistry.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/collections.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/context.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/decl_api.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/decl_base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/dependency.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/descriptor_props.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/dynamic.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/evaluator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/exc.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/identity.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/instrumentation.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/interfaces.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/loading.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/mapped_collection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/mapper.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/path_registry.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/persistence.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/properties.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/query.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/relationships.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/scoping.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/session.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/state.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/state_changes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/strategies.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/strategy_options.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/sync.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/unitofwork.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/__pycache__/writeonly.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/_orm_constructors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/_typing.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/attributes.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/bulk_persistence.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/clsregistry.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/collections.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/context.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/decl_api.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/decl_base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/dependency.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/descriptor_props.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/dynamic.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/evaluator.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/events.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/exc.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/identity.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/instrumentation.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/interfaces.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/loading.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/mapped_collection.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/mapper.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/path_registry.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/persistence.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/properties.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/query.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/relationships.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/scoping.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/session.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/state.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/state_changes.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/strategies.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/strategy_options.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/sync.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/unitofwork.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/orm/writeonly.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/__pycache__/events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/__pycache__/impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/events.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/pool/impl.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/py.typed create mode 100644 .venv/Lib/site-packages/sqlalchemy/schema.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/_dml_constructors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/_elements_constructors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/_orm_types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/_py_util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/_selectable_constructors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/_typing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/annotation.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/cache_key.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/coercions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/compiler.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/crud.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/ddl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/default_comparator.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/dml.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/elements.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/events.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/expression.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/functions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/lambdas.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/naming.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/operators.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/roles.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/selectable.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/sqltypes.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/traversals.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/type_api.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/__pycache__/visitors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/_dml_constructors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/_elements_constructors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/_orm_types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/_py_util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/_selectable_constructors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/_typing.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/annotation.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/cache_key.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/coercions.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/compiler.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/crud.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/ddl.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/default_comparator.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/dml.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/elements.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/events.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/expression.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/functions.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/lambdas.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/naming.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/operators.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/roles.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/schema.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/selectable.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/sqltypes.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/traversals.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/type_api.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/sql/visitors.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/assertions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/assertsql.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/asyncio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/engines.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/entities.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/exclusions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/pickleable.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/profiling.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/provision.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/requirements.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/schema.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/util.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/__pycache__/warnings.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/assertions.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/assertsql.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/asyncio.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/config.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/engines.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/entities.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/exclusions.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/__pycache__/mypy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/__pycache__/orm.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/__pycache__/sql.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/mypy.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/orm.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/fixtures/sql.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/pickleable.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/__pycache__/bootstrap.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/__pycache__/plugin_base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/__pycache__/pytestplugin.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/bootstrap.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/plugin_base.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/plugin/pytestplugin.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/profiling.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/provision.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/requirements.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/schema.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_cte.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_ddl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_deprecations.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_dialect.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_insert.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_reflection.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_results.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_rowcount.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_select.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_sequence.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_unicode_ddl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/__pycache__/test_update_delete.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_cte.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_ddl.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_deprecations.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_dialect.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_insert.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_reflection.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_results.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_rowcount.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_select.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_sequence.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_unicode_ddl.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/suite/test_update_delete.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/util.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/testing/warnings.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/types.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__init__.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/_collections.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/_concurrency_py3k.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/_has_cy.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/_py_collections.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/compat.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/concurrency.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/deprecations.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/langhelpers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/preloaded.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/queue.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/tool_support.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/topological.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/__pycache__/typing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/_collections.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/_concurrency_py3k.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/_has_cy.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/_py_collections.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/compat.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/concurrency.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/deprecations.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/langhelpers.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/preloaded.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/queue.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/tool_support.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/topological.py create mode 100644 .venv/Lib/site-packages/sqlalchemy/util/typing.py create mode 100644 .venv/Lib/site-packages/starlette-0.46.1.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/starlette-0.46.1.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/starlette-0.46.1.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/starlette-0.46.1.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/starlette-0.46.1.dist-info/licenses/LICENSE.md create mode 100644 .venv/Lib/site-packages/starlette/__init__.py create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/_exception_handler.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/_utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/applications.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/authentication.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/background.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/concurrency.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/convertors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/datastructures.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/endpoints.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/formparsers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/requests.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/responses.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/routing.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/schemas.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/staticfiles.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/status.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/templating.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/testclient.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/__pycache__/websockets.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/_exception_handler.py create mode 100644 .venv/Lib/site-packages/starlette/_utils.py create mode 100644 .venv/Lib/site-packages/starlette/applications.py create mode 100644 .venv/Lib/site-packages/starlette/authentication.py create mode 100644 .venv/Lib/site-packages/starlette/background.py create mode 100644 .venv/Lib/site-packages/starlette/concurrency.py create mode 100644 .venv/Lib/site-packages/starlette/config.py create mode 100644 .venv/Lib/site-packages/starlette/convertors.py create mode 100644 .venv/Lib/site-packages/starlette/datastructures.py create mode 100644 .venv/Lib/site-packages/starlette/endpoints.py create mode 100644 .venv/Lib/site-packages/starlette/exceptions.py create mode 100644 .venv/Lib/site-packages/starlette/formparsers.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/__init__.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/authentication.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/base.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/cors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/errors.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/exceptions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/gzip.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/httpsredirect.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/sessions.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/trustedhost.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/__pycache__/wsgi.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/starlette/middleware/authentication.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/base.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/cors.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/errors.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/exceptions.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/gzip.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/httpsredirect.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/sessions.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/trustedhost.py create mode 100644 .venv/Lib/site-packages/starlette/middleware/wsgi.py create mode 100644 .venv/Lib/site-packages/starlette/py.typed create mode 100644 .venv/Lib/site-packages/starlette/requests.py create mode 100644 .venv/Lib/site-packages/starlette/responses.py create mode 100644 .venv/Lib/site-packages/starlette/routing.py create mode 100644 .venv/Lib/site-packages/starlette/schemas.py create mode 100644 .venv/Lib/site-packages/starlette/staticfiles.py create mode 100644 .venv/Lib/site-packages/starlette/status.py create mode 100644 .venv/Lib/site-packages/starlette/templating.py create mode 100644 .venv/Lib/site-packages/starlette/testclient.py create mode 100644 .venv/Lib/site-packages/starlette/types.py create mode 100644 .venv/Lib/site-packages/starlette/websockets.py create mode 100644 .venv/Lib/site-packages/typing_extensions-4.12.2.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/typing_extensions-4.12.2.dist-info/LICENSE create mode 100644 .venv/Lib/site-packages/typing_extensions-4.12.2.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/typing_extensions-4.12.2.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/typing_extensions-4.12.2.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/typing_extensions.py create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/REQUESTED create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/entry_points.txt create mode 100644 .venv/Lib/site-packages/uvicorn-0.34.0.dist-info/licenses/LICENSE.md create mode 100644 .venv/Lib/site-packages/uvicorn/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/__main__.py create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/__main__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/_subprocess.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/_types.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/config.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/importer.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/logging.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/main.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/server.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/__pycache__/workers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/_subprocess.py create mode 100644 .venv/Lib/site-packages/uvicorn/_types.py create mode 100644 .venv/Lib/site-packages/uvicorn/config.py create mode 100644 .venv/Lib/site-packages/uvicorn/importer.py create mode 100644 .venv/Lib/site-packages/uvicorn/lifespan/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/lifespan/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/lifespan/__pycache__/off.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/lifespan/__pycache__/on.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/lifespan/off.py create mode 100644 .venv/Lib/site-packages/uvicorn/lifespan/on.py create mode 100644 .venv/Lib/site-packages/uvicorn/logging.py create mode 100644 .venv/Lib/site-packages/uvicorn/loops/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/loops/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/loops/__pycache__/asyncio.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/loops/__pycache__/auto.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/loops/__pycache__/uvloop.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/loops/asyncio.py create mode 100644 .venv/Lib/site-packages/uvicorn/loops/auto.py create mode 100644 .venv/Lib/site-packages/uvicorn/loops/uvloop.py create mode 100644 .venv/Lib/site-packages/uvicorn/main.py create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/__pycache__/asgi2.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/__pycache__/message_logger.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/__pycache__/proxy_headers.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/__pycache__/wsgi.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/asgi2.py create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/message_logger.py create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/proxy_headers.py create mode 100644 .venv/Lib/site-packages/uvicorn/middleware/wsgi.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/__pycache__/utils.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/__pycache__/auto.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/__pycache__/flow_control.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/__pycache__/h11_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/__pycache__/httptools_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/auto.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/flow_control.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/h11_impl.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/http/httptools_impl.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/utils.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/__pycache__/auto.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/__pycache__/websockets_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/__pycache__/wsproto_impl.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/auto.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/websockets_impl.py create mode 100644 .venv/Lib/site-packages/uvicorn/protocols/websockets/wsproto_impl.py create mode 100644 .venv/Lib/site-packages/uvicorn/py.typed create mode 100644 .venv/Lib/site-packages/uvicorn/server.py create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/__init__.py create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/__pycache__/basereload.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/__pycache__/multiprocess.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/__pycache__/statreload.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/__pycache__/watchfilesreload.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/basereload.py create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/multiprocess.py create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/statreload.py create mode 100644 .venv/Lib/site-packages/uvicorn/supervisors/watchfilesreload.py create mode 100644 .venv/Lib/site-packages/uvicorn/workers.py create mode 100644 .venv/Lib/site-packages/win32_setctime-1.2.0.dist-info/INSTALLER create mode 100644 .venv/Lib/site-packages/win32_setctime-1.2.0.dist-info/LICENSE create mode 100644 .venv/Lib/site-packages/win32_setctime-1.2.0.dist-info/METADATA create mode 100644 .venv/Lib/site-packages/win32_setctime-1.2.0.dist-info/RECORD create mode 100644 .venv/Lib/site-packages/win32_setctime-1.2.0.dist-info/WHEEL create mode 100644 .venv/Lib/site-packages/win32_setctime-1.2.0.dist-info/top_level.txt create mode 100644 .venv/Lib/site-packages/win32_setctime/__init__.py create mode 100644 .venv/Lib/site-packages/win32_setctime/__pycache__/__init__.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/win32_setctime/__pycache__/_setctime.cpython-312.pyc create mode 100644 .venv/Lib/site-packages/win32_setctime/_setctime.py create mode 100644 .venv/Lib/site-packages/win32_setctime/py.typed create mode 100644 .venv/Scripts/Activate.ps1 create mode 100644 .venv/Scripts/activate create mode 100644 .venv/Scripts/activate.bat create mode 100644 .venv/Scripts/deactivate.bat create mode 100644 .venv/Scripts/fastapi.exe create mode 100644 .venv/Scripts/pip.exe create mode 100644 .venv/Scripts/pip3.12.exe create mode 100644 .venv/Scripts/pip3.exe create mode 100644 .venv/Scripts/python.exe create mode 100644 .venv/Scripts/pythonw.exe create mode 100644 .venv/Scripts/uvicorn.exe create mode 100644 .venv/pyvenv.cfg create mode 100644 __pycache__/main.cpython-312.pyc create mode 100644 app/__pycache__/__init__.cpython-312.pyc create mode 100644 app/api/__pycache__/__init__.cpython-312.pyc create mode 100644 app/api/core/__pycache__/__init__.cpython-312.pyc create mode 100644 app/api/core/middleware/__pycache__/__init__.cpython-312.pyc create mode 100644 app/api/core/middleware/__pycache__/activity_tracker.cpython-312.pyc create mode 100644 app/api/db/__pycache__/__init__.cpython-312.pyc create mode 100644 app/api/db/__pycache__/database.cpython-312.pyc create mode 100644 app/api/v1/__pycache__/__init__.cpython-312.pyc create mode 100644 app/api/v1/routes/__pycache__/__init__.cpython-312.pyc create mode 100644 blog_app.db diff --git a/.venv/Include/site/python3.12/greenlet/greenlet.h b/.venv/Include/site/python3.12/greenlet/greenlet.h new file mode 100644 index 0000000..d02a16e --- /dev/null +++ b/.venv/Include/site/python3.12/greenlet/greenlet.h @@ -0,0 +1,164 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ + +/* Greenlet object interface */ + +#ifndef Py_GREENLETOBJECT_H +#define Py_GREENLETOBJECT_H + + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* This is deprecated and undocumented. It does not change. */ +#define GREENLET_VERSION "1.0.0" + +#ifndef GREENLET_MODULE +#define implementation_ptr_t void* +#endif + +typedef struct _greenlet { + PyObject_HEAD + PyObject* weakreflist; + PyObject* dict; + implementation_ptr_t pimpl; +} PyGreenlet; + +#define PyGreenlet_Check(op) (op && PyObject_TypeCheck(op, &PyGreenlet_Type)) + + +/* C API functions */ + +/* Total number of symbols that are exported */ +#define PyGreenlet_API_pointers 12 + +#define PyGreenlet_Type_NUM 0 +#define PyExc_GreenletError_NUM 1 +#define PyExc_GreenletExit_NUM 2 + +#define PyGreenlet_New_NUM 3 +#define PyGreenlet_GetCurrent_NUM 4 +#define PyGreenlet_Throw_NUM 5 +#define PyGreenlet_Switch_NUM 6 +#define PyGreenlet_SetParent_NUM 7 + +#define PyGreenlet_MAIN_NUM 8 +#define PyGreenlet_STARTED_NUM 9 +#define PyGreenlet_ACTIVE_NUM 10 +#define PyGreenlet_GET_PARENT_NUM 11 + +#ifndef GREENLET_MODULE +/* This section is used by modules that uses the greenlet C API */ +static void** _PyGreenlet_API = NULL; + +# define PyGreenlet_Type \ + (*(PyTypeObject*)_PyGreenlet_API[PyGreenlet_Type_NUM]) + +# define PyExc_GreenletError \ + ((PyObject*)_PyGreenlet_API[PyExc_GreenletError_NUM]) + +# define PyExc_GreenletExit \ + ((PyObject*)_PyGreenlet_API[PyExc_GreenletExit_NUM]) + +/* + * PyGreenlet_New(PyObject *args) + * + * greenlet.greenlet(run, parent=None) + */ +# define PyGreenlet_New \ + (*(PyGreenlet * (*)(PyObject * run, PyGreenlet * parent)) \ + _PyGreenlet_API[PyGreenlet_New_NUM]) + +/* + * PyGreenlet_GetCurrent(void) + * + * greenlet.getcurrent() + */ +# define PyGreenlet_GetCurrent \ + (*(PyGreenlet * (*)(void)) _PyGreenlet_API[PyGreenlet_GetCurrent_NUM]) + +/* + * PyGreenlet_Throw( + * PyGreenlet *greenlet, + * PyObject *typ, + * PyObject *val, + * PyObject *tb) + * + * g.throw(...) + */ +# define PyGreenlet_Throw \ + (*(PyObject * (*)(PyGreenlet * self, \ + PyObject * typ, \ + PyObject * val, \ + PyObject * tb)) \ + _PyGreenlet_API[PyGreenlet_Throw_NUM]) + +/* + * PyGreenlet_Switch(PyGreenlet *greenlet, PyObject *args) + * + * g.switch(*args, **kwargs) + */ +# define PyGreenlet_Switch \ + (*(PyObject * \ + (*)(PyGreenlet * greenlet, PyObject * args, PyObject * kwargs)) \ + _PyGreenlet_API[PyGreenlet_Switch_NUM]) + +/* + * PyGreenlet_SetParent(PyObject *greenlet, PyObject *new_parent) + * + * g.parent = new_parent + */ +# define PyGreenlet_SetParent \ + (*(int (*)(PyGreenlet * greenlet, PyGreenlet * nparent)) \ + _PyGreenlet_API[PyGreenlet_SetParent_NUM]) + +/* + * PyGreenlet_GetParent(PyObject* greenlet) + * + * return greenlet.parent; + * + * This could return NULL even if there is no exception active. + * If it does not return NULL, you are responsible for decrementing the + * reference count. + */ +# define PyGreenlet_GetParent \ + (*(PyGreenlet* (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM]) + +/* + * deprecated, undocumented alias. + */ +# define PyGreenlet_GET_PARENT PyGreenlet_GetParent + +# define PyGreenlet_MAIN \ + (*(int (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_MAIN_NUM]) + +# define PyGreenlet_STARTED \ + (*(int (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_STARTED_NUM]) + +# define PyGreenlet_ACTIVE \ + (*(int (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_ACTIVE_NUM]) + + + + +/* Macro that imports greenlet and initializes C API */ +/* NOTE: This has actually moved to ``greenlet._greenlet._C_API``, but we + keep the older definition to be sure older code that might have a copy of + the header still works. */ +# define PyGreenlet_Import() \ + { \ + _PyGreenlet_API = (void**)PyCapsule_Import("greenlet._C_API", 0); \ + } + +#endif /* GREENLET_MODULE */ + +#ifdef __cplusplus +} +#endif +#endif /* !Py_GREENLETOBJECT_H */ diff --git a/.venv/Lib/site-packages/__pycache__/typing_extensions.cpython-312.pyc b/.venv/Lib/site-packages/__pycache__/typing_extensions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..00955def5a03c480445dffca72ae1b473896625f GIT binary patch literal 139417 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA new file mode 100644 index 0000000..3ac05cf --- /dev/null +++ b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/METADATA @@ -0,0 +1,295 @@ +Metadata-Version: 2.3 +Name: annotated-types +Version: 0.7.0 +Summary: Reusable constraint types to use with typing.Annotated +Project-URL: Homepage, https://github.com/annotated-types/annotated-types +Project-URL: Source, https://github.com/annotated-types/annotated-types +Project-URL: Changelog, https://github.com/annotated-types/annotated-types/releases +Author-email: Adrian Garcia Badaracco <1755071+adriangb@users.noreply.github.com>, Samuel Colvin , Zac Hatfield-Dodds +License-File: LICENSE +Classifier: Development Status :: 4 - Beta +Classifier: Environment :: Console +Classifier: Environment :: MacOS X +Classifier: Intended Audience :: Developers +Classifier: Intended Audience :: Information Technology +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: POSIX :: Linux +Classifier: Operating System :: Unix +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: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Typing :: Typed +Requires-Python: >=3.8 +Requires-Dist: typing-extensions>=4.0.0; python_version < '3.9' +Description-Content-Type: text/markdown + +# annotated-types + +[![CI](https://github.com/annotated-types/annotated-types/workflows/CI/badge.svg?event=push)](https://github.com/annotated-types/annotated-types/actions?query=event%3Apush+branch%3Amain+workflow%3ACI) +[![pypi](https://img.shields.io/pypi/v/annotated-types.svg)](https://pypi.python.org/pypi/annotated-types) +[![versions](https://img.shields.io/pypi/pyversions/annotated-types.svg)](https://github.com/annotated-types/annotated-types) +[![license](https://img.shields.io/github/license/annotated-types/annotated-types.svg)](https://github.com/annotated-types/annotated-types/blob/main/LICENSE) + +[PEP-593](https://peps.python.org/pep-0593/) added `typing.Annotated` as a way of +adding context-specific metadata to existing types, and specifies that +`Annotated[T, x]` _should_ be treated as `T` by any tool or library without special +logic for `x`. + +This package provides metadata objects which can be used to represent common +constraints such as upper and lower bounds on scalar values and collection sizes, +a `Predicate` marker for runtime checks, and +descriptions of how we intend these metadata to be interpreted. In some cases, +we also note alternative representations which do not require this package. + +## Install + +```bash +pip install annotated-types +``` + +## Examples + +```python +from typing import Annotated +from annotated_types import Gt, Len, Predicate + +class MyClass: + age: Annotated[int, Gt(18)] # Valid: 19, 20, ... + # Invalid: 17, 18, "19", 19.0, ... + factors: list[Annotated[int, Predicate(is_prime)]] # Valid: 2, 3, 5, 7, 11, ... + # Invalid: 4, 8, -2, 5.0, "prime", ... + + my_list: Annotated[list[int], Len(0, 10)] # Valid: [], [10, 20, 30, 40, 50] + # Invalid: (1, 2), ["abc"], [0] * 20 +``` + +## Documentation + +_While `annotated-types` avoids runtime checks for performance, users should not +construct invalid combinations such as `MultipleOf("non-numeric")` or `Annotated[int, Len(3)]`. +Downstream implementors may choose to raise an error, emit a warning, silently ignore +a metadata item, etc., if the metadata objects described below are used with an +incompatible type - or for any other reason!_ + +### Gt, Ge, Lt, Le + +Express inclusive and/or exclusive bounds on orderable values - which may be numbers, +dates, times, strings, sets, etc. Note that the boundary value need not be of the +same type that was annotated, so long as they can be compared: `Annotated[int, Gt(1.5)]` +is fine, for example, and implies that the value is an integer x such that `x > 1.5`. + +We suggest that implementors may also interpret `functools.partial(operator.le, 1.5)` +as being equivalent to `Gt(1.5)`, for users who wish to avoid a runtime dependency on +the `annotated-types` package. + +To be explicit, these types have the following meanings: + +* `Gt(x)` - value must be "Greater Than" `x` - equivalent to exclusive minimum +* `Ge(x)` - value must be "Greater than or Equal" to `x` - equivalent to inclusive minimum +* `Lt(x)` - value must be "Less Than" `x` - equivalent to exclusive maximum +* `Le(x)` - value must be "Less than or Equal" to `x` - equivalent to inclusive maximum + +### Interval + +`Interval(gt, ge, lt, le)` allows you to specify an upper and lower bound with a single +metadata object. `None` attributes should be ignored, and non-`None` attributes +treated as per the single bounds above. + +### MultipleOf + +`MultipleOf(multiple_of=x)` might be interpreted in two ways: + +1. Python semantics, implying `value % multiple_of == 0`, or +2. [JSONschema semantics](https://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.6.2.1), + where `int(value / multiple_of) == value / multiple_of`. + +We encourage users to be aware of these two common interpretations and their +distinct behaviours, especially since very large or non-integer numbers make +it easy to cause silent data corruption due to floating-point imprecision. + +We encourage libraries to carefully document which interpretation they implement. + +### MinLen, MaxLen, Len + +`Len()` implies that `min_length <= len(value) <= max_length` - lower and upper bounds are inclusive. + +As well as `Len()` which can optionally include upper and lower bounds, we also +provide `MinLen(x)` and `MaxLen(y)` which are equivalent to `Len(min_length=x)` +and `Len(max_length=y)` respectively. + +`Len`, `MinLen`, and `MaxLen` may be used with any type which supports `len(value)`. + +Examples of usage: + +* `Annotated[list, MaxLen(10)]` (or `Annotated[list, Len(max_length=10))`) - list must have a length of 10 or less +* `Annotated[str, MaxLen(10)]` - string must have a length of 10 or less +* `Annotated[list, MinLen(3))` (or `Annotated[list, Len(min_length=3))`) - list must have a length of 3 or more +* `Annotated[list, Len(4, 6)]` - list must have a length of 4, 5, or 6 +* `Annotated[list, Len(8, 8)]` - list must have a length of exactly 8 + +#### Changed in v0.4.0 + +* `min_inclusive` has been renamed to `min_length`, no change in meaning +* `max_exclusive` has been renamed to `max_length`, upper bound is now **inclusive** instead of **exclusive** +* The recommendation that slices are interpreted as `Len` has been removed due to ambiguity and different semantic + meaning of the upper bound in slices vs. `Len` + +See [issue #23](https://github.com/annotated-types/annotated-types/issues/23) for discussion. + +### Timezone + +`Timezone` can be used with a `datetime` or a `time` to express which timezones +are allowed. `Annotated[datetime, Timezone(None)]` must be a naive datetime. +`Timezone[...]` ([literal ellipsis](https://docs.python.org/3/library/constants.html#Ellipsis)) +expresses that any timezone-aware datetime is allowed. You may also pass a specific +timezone string or [`tzinfo`](https://docs.python.org/3/library/datetime.html#tzinfo-objects) +object such as `Timezone(timezone.utc)` or `Timezone("Africa/Abidjan")` to express that you only +allow a specific timezone, though we note that this is often a symptom of fragile design. + +#### Changed in v0.x.x + +* `Timezone` accepts [`tzinfo`](https://docs.python.org/3/library/datetime.html#tzinfo-objects) objects instead of + `timezone`, extending compatibility to [`zoneinfo`](https://docs.python.org/3/library/zoneinfo.html) and third party libraries. + +### Unit + +`Unit(unit: str)` expresses that the annotated numeric value is the magnitude of +a quantity with the specified unit. For example, `Annotated[float, Unit("m/s")]` +would be a float representing a velocity in meters per second. + +Please note that `annotated_types` itself makes no attempt to parse or validate +the unit string in any way. That is left entirely to downstream libraries, +such as [`pint`](https://pint.readthedocs.io) or +[`astropy.units`](https://docs.astropy.org/en/stable/units/). + +An example of how a library might use this metadata: + +```python +from annotated_types import Unit +from typing import Annotated, TypeVar, Callable, Any, get_origin, get_args + +# given a type annotated with a unit: +Meters = Annotated[float, Unit("m")] + + +# you can cast the annotation to a specific unit type with any +# callable that accepts a string and returns the desired type +T = TypeVar("T") +def cast_unit(tp: Any, unit_cls: Callable[[str], T]) -> T | None: + if get_origin(tp) is Annotated: + for arg in get_args(tp): + if isinstance(arg, Unit): + return unit_cls(arg.unit) + return None + + +# using `pint` +import pint +pint_unit = cast_unit(Meters, pint.Unit) + + +# using `astropy.units` +import astropy.units as u +astropy_unit = cast_unit(Meters, u.Unit) +``` + +### Predicate + +`Predicate(func: Callable)` expresses that `func(value)` is truthy for valid values. +Users should prefer the statically inspectable metadata above, but if you need +the full power and flexibility of arbitrary runtime predicates... here it is. + +For some common constraints, we provide generic types: + +* `IsLower = Annotated[T, Predicate(str.islower)]` +* `IsUpper = Annotated[T, Predicate(str.isupper)]` +* `IsDigit = Annotated[T, Predicate(str.isdigit)]` +* `IsFinite = Annotated[T, Predicate(math.isfinite)]` +* `IsNotFinite = Annotated[T, Predicate(Not(math.isfinite))]` +* `IsNan = Annotated[T, Predicate(math.isnan)]` +* `IsNotNan = Annotated[T, Predicate(Not(math.isnan))]` +* `IsInfinite = Annotated[T, Predicate(math.isinf)]` +* `IsNotInfinite = Annotated[T, Predicate(Not(math.isinf))]` + +so that you can write e.g. `x: IsFinite[float] = 2.0` instead of the longer +(but exactly equivalent) `x: Annotated[float, Predicate(math.isfinite)] = 2.0`. + +Some libraries might have special logic to handle known or understandable predicates, +for example by checking for `str.isdigit` and using its presence to both call custom +logic to enforce digit-only strings, and customise some generated external schema. +Users are therefore encouraged to avoid indirection like `lambda s: s.lower()`, in +favor of introspectable methods such as `str.lower` or `re.compile("pattern").search`. + +To enable basic negation of commonly used predicates like `math.isnan` without introducing introspection that makes it impossible for implementers to introspect the predicate we provide a `Not` wrapper that simply negates the predicate in an introspectable manner. Several of the predicates listed above are created in this manner. + +We do not specify what behaviour should be expected for predicates that raise +an exception. For example `Annotated[int, Predicate(str.isdigit)]` might silently +skip invalid constraints, or statically raise an error; or it might try calling it +and then propagate or discard the resulting +`TypeError: descriptor 'isdigit' for 'str' objects doesn't apply to a 'int' object` +exception. We encourage libraries to document the behaviour they choose. + +### Doc + +`doc()` can be used to add documentation information in `Annotated`, for function and method parameters, variables, class attributes, return types, and any place where `Annotated` can be used. + +It expects a value that can be statically analyzed, as the main use case is for static analysis, editors, documentation generators, and similar tools. + +It returns a `DocInfo` class with a single attribute `documentation` containing the value passed to `doc()`. + +This is the early adopter's alternative form of the [`typing-doc` proposal](https://github.com/tiangolo/fastapi/blob/typing-doc/typing_doc.md). + +### Integrating downstream types with `GroupedMetadata` + +Implementers may choose to provide a convenience wrapper that groups multiple pieces of metadata. +This can help reduce verbosity and cognitive overhead for users. +For example, an implementer like Pydantic might provide a `Field` or `Meta` type that accepts keyword arguments and transforms these into low-level metadata: + +```python +from dataclasses import dataclass +from typing import Iterator +from annotated_types import GroupedMetadata, Ge + +@dataclass +class Field(GroupedMetadata): + ge: int | None = None + description: str | None = None + + def __iter__(self) -> Iterator[object]: + # Iterating over a GroupedMetadata object should yield annotated-types + # constraint metadata objects which describe it as fully as possible, + # and may include other unknown objects too. + if self.ge is not None: + yield Ge(self.ge) + if self.description is not None: + yield Description(self.description) +``` + +Libraries consuming annotated-types constraints should check for `GroupedMetadata` and unpack it by iterating over the object and treating the results as if they had been "unpacked" in the `Annotated` type. The same logic should be applied to the [PEP 646 `Unpack` type](https://peps.python.org/pep-0646/), so that `Annotated[T, Field(...)]`, `Annotated[T, Unpack[Field(...)]]` and `Annotated[T, *Field(...)]` are all treated consistently. + +Libraries consuming annotated-types should also ignore any metadata they do not recongize that came from unpacking a `GroupedMetadata`, just like they ignore unrecognized metadata in `Annotated` itself. + +Our own `annotated_types.Interval` class is a `GroupedMetadata` which unpacks itself into `Gt`, `Lt`, etc., so this is not an abstract concern. Similarly, `annotated_types.Len` is a `GroupedMetadata` which unpacks itself into `MinLen` (optionally) and `MaxLen`. + +### Consuming metadata + +We intend to not be prescriptive as to _how_ the metadata and constraints are used, but as an example of how one might parse constraints from types annotations see our [implementation in `test_main.py`](https://github.com/annotated-types/annotated-types/blob/f59cf6d1b5255a0fe359b93896759a180bec30ae/tests/test_main.py#L94-L103). + +It is up to the implementer to determine how this metadata is used. +You could use the metadata for runtime type checking, for generating schemas or to generate example data, amongst other use cases. + +## Design & History + +This package was designed at the PyCon 2022 sprints by the maintainers of Pydantic +and Hypothesis, with the goal of making it as easy as possible for end-users to +provide more informative annotations for use by runtime libraries. + +It is deliberately minimal, and following PEP-593 allows considerable downstream +discretion in what (if anything!) they choose to support. Nonetheless, we expect +that staying simple and covering _only_ the most common use-cases will give users +and maintainers the best experience we can. If you'd like more constraints for your +types - follow our lead, by defining them and documenting them downstream! diff --git a/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD new file mode 100644 index 0000000..7045729 --- /dev/null +++ b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/RECORD @@ -0,0 +1,10 @@ +annotated_types-0.7.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +annotated_types-0.7.0.dist-info/METADATA,sha256=7ltqxksJJ0wCYFGBNIQCWTlWQGeAH0hRFdnK3CB895E,15046 +annotated_types-0.7.0.dist-info/RECORD,, +annotated_types-0.7.0.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87 +annotated_types-0.7.0.dist-info/licenses/LICENSE,sha256=_hBJiEsaDZNCkB6I4H8ykl0ksxIdmXK2poBfuYJLCV0,1083 +annotated_types/__init__.py,sha256=RynLsRKUEGI0KimXydlD1fZEfEzWwDo0Uon3zOKhG1Q,13819 +annotated_types/__pycache__/__init__.cpython-312.pyc,, +annotated_types/__pycache__/test_cases.cpython-312.pyc,, +annotated_types/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +annotated_types/test_cases.py,sha256=zHFX6EpcMbGJ8FzBYDbO56bPwx_DYIVSKbZM-4B3_lg,6421 diff --git a/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL new file mode 100644 index 0000000..516596c --- /dev/null +++ b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.24.2 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE new file mode 100644 index 0000000..d99323a --- /dev/null +++ b/.venv/Lib/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2022 the 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/.venv/Lib/site-packages/annotated_types/__init__.py b/.venv/Lib/site-packages/annotated_types/__init__.py new file mode 100644 index 0000000..74e0dee --- /dev/null +++ b/.venv/Lib/site-packages/annotated_types/__init__.py @@ -0,0 +1,432 @@ +import math +import sys +import types +from dataclasses import dataclass +from datetime import tzinfo +from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union + +if sys.version_info < (3, 8): + from typing_extensions import Protocol, runtime_checkable +else: + from typing import Protocol, runtime_checkable + +if sys.version_info < (3, 9): + from typing_extensions import Annotated, Literal +else: + from typing import Annotated, Literal + +if sys.version_info < (3, 10): + EllipsisType = type(Ellipsis) + KW_ONLY = {} + SLOTS = {} +else: + from types import EllipsisType + + KW_ONLY = {"kw_only": True} + SLOTS = {"slots": True} + + +__all__ = ( + 'BaseMetadata', + 'GroupedMetadata', + 'Gt', + 'Ge', + 'Lt', + 'Le', + 'Interval', + 'MultipleOf', + 'MinLen', + 'MaxLen', + 'Len', + 'Timezone', + 'Predicate', + 'LowerCase', + 'UpperCase', + 'IsDigits', + 'IsFinite', + 'IsNotFinite', + 'IsNan', + 'IsNotNan', + 'IsInfinite', + 'IsNotInfinite', + 'doc', + 'DocInfo', + '__version__', +) + +__version__ = '0.7.0' + + +T = TypeVar('T') + + +# arguments that start with __ are considered +# positional only +# see https://peps.python.org/pep-0484/#positional-only-arguments + + +class SupportsGt(Protocol): + def __gt__(self: T, __other: T) -> bool: + ... + + +class SupportsGe(Protocol): + def __ge__(self: T, __other: T) -> bool: + ... + + +class SupportsLt(Protocol): + def __lt__(self: T, __other: T) -> bool: + ... + + +class SupportsLe(Protocol): + def __le__(self: T, __other: T) -> bool: + ... + + +class SupportsMod(Protocol): + def __mod__(self: T, __other: T) -> T: + ... + + +class SupportsDiv(Protocol): + def __div__(self: T, __other: T) -> T: + ... + + +class BaseMetadata: + """Base class for all metadata. + + This exists mainly so that implementers + can do `isinstance(..., BaseMetadata)` while traversing field annotations. + """ + + __slots__ = () + + +@dataclass(frozen=True, **SLOTS) +class Gt(BaseMetadata): + """Gt(gt=x) implies that the value must be greater than x. + + It can be used with any type that supports the ``>`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + gt: SupportsGt + + +@dataclass(frozen=True, **SLOTS) +class Ge(BaseMetadata): + """Ge(ge=x) implies that the value must be greater than or equal to x. + + It can be used with any type that supports the ``>=`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + ge: SupportsGe + + +@dataclass(frozen=True, **SLOTS) +class Lt(BaseMetadata): + """Lt(lt=x) implies that the value must be less than x. + + It can be used with any type that supports the ``<`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + lt: SupportsLt + + +@dataclass(frozen=True, **SLOTS) +class Le(BaseMetadata): + """Le(le=x) implies that the value must be less than or equal to x. + + It can be used with any type that supports the ``<=`` operator, + including numbers, dates and times, strings, sets, and so on. + """ + + le: SupportsLe + + +@runtime_checkable +class GroupedMetadata(Protocol): + """A grouping of multiple objects, like typing.Unpack. + + `GroupedMetadata` on its own is not metadata and has no meaning. + All of the constraints and metadata should be fully expressable + in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`. + + Concrete implementations should override `GroupedMetadata.__iter__()` + to add their own metadata. + For example: + + >>> @dataclass + >>> class Field(GroupedMetadata): + >>> gt: float | None = None + >>> description: str | None = None + ... + >>> def __iter__(self) -> Iterable[object]: + >>> if self.gt is not None: + >>> yield Gt(self.gt) + >>> if self.description is not None: + >>> yield Description(self.gt) + + Also see the implementation of `Interval` below for an example. + + Parsers should recognize this and unpack it so that it can be used + both with and without unpacking: + + - `Annotated[int, Field(...)]` (parser must unpack Field) + - `Annotated[int, *Field(...)]` (PEP-646) + """ # noqa: trailing-whitespace + + @property + def __is_annotated_types_grouped_metadata__(self) -> Literal[True]: + return True + + def __iter__(self) -> Iterator[object]: + ... + + if not TYPE_CHECKING: + __slots__ = () # allow subclasses to use slots + + def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None: + # Basic ABC like functionality without the complexity of an ABC + super().__init_subclass__(*args, **kwargs) + if cls.__iter__ is GroupedMetadata.__iter__: + raise TypeError("Can't subclass GroupedMetadata without implementing __iter__") + + def __iter__(self) -> Iterator[object]: # noqa: F811 + raise NotImplementedError # more helpful than "None has no attribute..." type errors + + +@dataclass(frozen=True, **KW_ONLY, **SLOTS) +class Interval(GroupedMetadata): + """Interval can express inclusive or exclusive bounds with a single object. + + It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which + are interpreted the same way as the single-bound constraints. + """ + + gt: Union[SupportsGt, None] = None + ge: Union[SupportsGe, None] = None + lt: Union[SupportsLt, None] = None + le: Union[SupportsLe, None] = None + + def __iter__(self) -> Iterator[BaseMetadata]: + """Unpack an Interval into zero or more single-bounds.""" + if self.gt is not None: + yield Gt(self.gt) + if self.ge is not None: + yield Ge(self.ge) + if self.lt is not None: + yield Lt(self.lt) + if self.le is not None: + yield Le(self.le) + + +@dataclass(frozen=True, **SLOTS) +class MultipleOf(BaseMetadata): + """MultipleOf(multiple_of=x) might be interpreted in two ways: + + 1. Python semantics, implying ``value % multiple_of == 0``, or + 2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of`` + + We encourage users to be aware of these two common interpretations, + and libraries to carefully document which they implement. + """ + + multiple_of: Union[SupportsDiv, SupportsMod] + + +@dataclass(frozen=True, **SLOTS) +class MinLen(BaseMetadata): + """ + MinLen() implies minimum inclusive length, + e.g. ``len(value) >= min_length``. + """ + + min_length: Annotated[int, Ge(0)] + + +@dataclass(frozen=True, **SLOTS) +class MaxLen(BaseMetadata): + """ + MaxLen() implies maximum inclusive length, + e.g. ``len(value) <= max_length``. + """ + + max_length: Annotated[int, Ge(0)] + + +@dataclass(frozen=True, **SLOTS) +class Len(GroupedMetadata): + """ + Len() implies that ``min_length <= len(value) <= max_length``. + + Upper bound may be omitted or ``None`` to indicate no upper length bound. + """ + + min_length: Annotated[int, Ge(0)] = 0 + max_length: Optional[Annotated[int, Ge(0)]] = None + + def __iter__(self) -> Iterator[BaseMetadata]: + """Unpack a Len into zone or more single-bounds.""" + if self.min_length > 0: + yield MinLen(self.min_length) + if self.max_length is not None: + yield MaxLen(self.max_length) + + +@dataclass(frozen=True, **SLOTS) +class Timezone(BaseMetadata): + """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive). + + ``Annotated[datetime, Timezone(None)]`` must be a naive datetime. + ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be + tz-aware but any timezone is allowed. + + You may also pass a specific timezone string or tzinfo object such as + ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that + you only allow a specific timezone, though we note that this is often + a symptom of poor design. + """ + + tz: Union[str, tzinfo, EllipsisType, None] + + +@dataclass(frozen=True, **SLOTS) +class Unit(BaseMetadata): + """Indicates that the value is a physical quantity with the specified unit. + + It is intended for usage with numeric types, where the value represents the + magnitude of the quantity. For example, ``distance: Annotated[float, Unit('m')]`` + or ``speed: Annotated[float, Unit('m/s')]``. + + Interpretation of the unit string is left to the discretion of the consumer. + It is suggested to follow conventions established by python libraries that work + with physical quantities, such as + + - ``pint`` : + - ``astropy.units``: + + For indicating a quantity with a certain dimensionality but without a specific unit + it is recommended to use square brackets, e.g. `Annotated[float, Unit('[time]')]`. + Note, however, ``annotated_types`` itself makes no use of the unit string. + """ + + unit: str + + +@dataclass(frozen=True, **SLOTS) +class Predicate(BaseMetadata): + """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values. + + Users should prefer statically inspectable metadata, but if you need the full + power and flexibility of arbitrary runtime predicates... here it is. + + We provide a few predefined predicates for common string constraints: + ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and + ``IsDigits = Predicate(str.isdigit)``. Users are encouraged to use methods which + can be given special handling, and avoid indirection like ``lambda s: s.lower()``. + + Some libraries might have special logic to handle certain predicates, e.g. by + checking for `str.isdigit` and using its presence to both call custom logic to + enforce digit-only strings, and customise some generated external schema. + + We do not specify what behaviour should be expected for predicates that raise + an exception. For example `Annotated[int, Predicate(str.isdigit)]` might silently + skip invalid constraints, or statically raise an error; or it might try calling it + and then propagate or discard the resulting exception. + """ + + func: Callable[[Any], bool] + + def __repr__(self) -> str: + if getattr(self.func, "__name__", "") == "": + return f"{self.__class__.__name__}({self.func!r})" + if isinstance(self.func, (types.MethodType, types.BuiltinMethodType)) and ( + namespace := getattr(self.func.__self__, "__name__", None) + ): + return f"{self.__class__.__name__}({namespace}.{self.func.__name__})" + if isinstance(self.func, type(str.isascii)): # method descriptor + return f"{self.__class__.__name__}({self.func.__qualname__})" + return f"{self.__class__.__name__}({self.func.__name__})" + + +@dataclass +class Not: + func: Callable[[Any], bool] + + def __call__(self, __v: Any) -> bool: + return not self.func(__v) + + +_StrType = TypeVar("_StrType", bound=str) + +LowerCase = Annotated[_StrType, Predicate(str.islower)] +""" +Return True if the string is a lowercase string, False otherwise. + +A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string. +""" # noqa: E501 +UpperCase = Annotated[_StrType, Predicate(str.isupper)] +""" +Return True if the string is an uppercase string, False otherwise. + +A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string. +""" # noqa: E501 +IsDigit = Annotated[_StrType, Predicate(str.isdigit)] +IsDigits = IsDigit # type: ignore # plural for backwards compatibility, see #63 +""" +Return True if the string is a digit string, False otherwise. + +A string is a digit string if all characters in the string are digits and there is at least one character in the string. +""" # noqa: E501 +IsAscii = Annotated[_StrType, Predicate(str.isascii)] +""" +Return True if all characters in the string are ASCII, False otherwise. + +ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too. +""" + +_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex]) +IsFinite = Annotated[_NumericType, Predicate(math.isfinite)] +"""Return True if x is neither an infinity nor a NaN, and False otherwise.""" +IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))] +"""Return True if x is one of infinity or NaN, and False otherwise""" +IsNan = Annotated[_NumericType, Predicate(math.isnan)] +"""Return True if x is a NaN (not a number), and False otherwise.""" +IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))] +"""Return True if x is anything but NaN (not a number), and False otherwise.""" +IsInfinite = Annotated[_NumericType, Predicate(math.isinf)] +"""Return True if x is a positive or negative infinity, and False otherwise.""" +IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))] +"""Return True if x is neither a positive or negative infinity, and False otherwise.""" + +try: + from typing_extensions import DocInfo, doc # type: ignore [attr-defined] +except ImportError: + + @dataclass(frozen=True, **SLOTS) + class DocInfo: # type: ignore [no-redef] + """ " + The return value of doc(), mainly to be used by tools that want to extract the + Annotated documentation at runtime. + """ + + documentation: str + """The documentation string passed to doc().""" + + def doc( + documentation: str, + ) -> DocInfo: + """ + Add documentation to a type annotation inside of Annotated. + + For example: + + >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ... + """ + return DocInfo(documentation) diff --git a/.venv/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/annotated_types/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d851bc0a94b61e7f43fadd5261c3b4deb163bca3 GIT binary patch literal 18644 zcmc(GYit}>c4k#S$ZmG?O+854QjvPGC9)~&X-gC})N^Q4l)RGSxGkr<*i}uI*xf}} zRZD6{v%{Hq5*bJ)bS8;7m<%E>ygSr73)@KmJ3xRK^D96y*rw@)m>N&UK@w!=9~CM) zvso;#-?_J{Uu?>x=aRsJ|h$A+s^I(WxK6*ou&K>IYfuZA2rnbNBb=us@pzVNm zltCp1-2mvuGH5r0ZUS_38MKE%I|1z~gKlHcCjfo247!~`p8|Bt+n_K#u^kwvPdTk@ zrO~TTyd{2HWLOfgy44--NZ;n@LTu+c_&vbiRs(<6I{4dxzoQ0z?>hK9fxoK;enjnH zbQ=&;9@cV0wp>G}hDDVer;P`)iDUU>*Dez&}`{{k`kp9|Hd28u(AIgZ~WhpRIwvPxY}iI)d_}F6R|j zXg^wORtD7re{#$%iyc%qs0RVxryjVPc37|Mr@Hf>FXhNs`@%zs*ApU`!oAGTf%qxdPtqBzP=h1f^_m6hm0SIjbxsS zJtqozahsq%zg;kTM52E!$@Ud+;jqhTMJ^msPN)Zzlj=yyr<{7t7klm{v~^v$;eAQC zE=JD$jHWUc5$&KNTXHfjngkiukBptQy~EkO9XKhc z)AD#)wF4uTYRHyu*n#uYmZoRrwB2|yH$ANzmU$+v%U0><6&SrH>wp7Kg zAJu3WX%~Z308Ao$I-S<0P0ge(?fR+faXp*PU$XsXTDQzdryV{ao9a2$l46Y`uj~_Cc zWH8D#jF=Ih(1AqNt9bD5Reh;C#RtCe=lzj7yTM&t(8gz~>6G0TFM;B5-I`PlyUtLp zoRLjBXK}GNTIy9F>nShX702#k%?+q&f^i6mN$8UF@7Bp9S1y|v_!U`G49&c9A)lO- zjSP6>s+zRSE7L~*gqr1ycO|V)m{-P;#^vehcqTXX?A|NUYijn|l~HZ{iV1S|Ps`w- z2^HiY?wMb5RYeN zFlgLvh{rR!l1o!Q9FM=6lheG!*auwOH?HexV-Q*62qi<59Hr!do18*s^+_bJ2`e7a zAD(+*MZoJ$D}PxJ=oha@bsp0as*LvKD~K7e6*LZ0FArTl<5{4v3At-{1^{Ob+4LAm z(P9}%RU#=s&r#iDln^mMP2)KI_zES%ln~*J6O??Fk}A59JhU0L zs%bL{=J?{Yc^)IHrcJtn-9|0YhCt_OI*&%1bA(z&8%A16#;CAF8v;Eh+N|N5(J#d} z7cjClw5i~mQQ{lgUYBT2k4BsSK&Vx;VWg$xA{CZsL!i$|8?Pf4eM~HdT%mDJS2*Le z7sVn#UxsroV{8@Fsb|s#+p4{+Q_u$@C?0=_CRRouf6a~cB4Jh0hLM(%U&VigERwkp z>SnJ6u}l^b`s1P7DeYP{-2nPBbbA?NtEQVmO_u0}9zZt+{54>IHr-w!tSY+22u2Aj zB;s*dM4$@VIOevn+JTbtqc(=4Hs;HFBR+$){+aKSS|Tx3OiJm71Z7LgI9f`yp+UlP zX;L#K^@e6zrj(I2s5O$QOV*@pNm>SaNk%1A#bmfiIV&l;l+a8qYg%$PsrE*r(LSkM z`H3W?>yuhql`KPMDnoWcN@;3Zk(?tFI)oWz&9V89MXDLg23tb;zzGK6# zLx(IQX;0F|)bMI2NQ& zf~tve$XP`q?G^yjGJrrC)j~=oSV}$1scm~EtQyB-9MfakgWVjDmo3p+niC-mO32z= zC7ORrxbNdM54OKH#%WFnUzpaUx6J(avuf{z`gv&$?p8@%k}Um8(EZpihw$opglFo9 zf>~EHI8nl&p?Kahc|0i-5HLAQjWN+a zj6)gSlH^a~Y{a>#WzhtQZ}+U0%t<|mBNQh{DwoC)t=^b6usz9{;T#VVPMr)o<_#sv zkL1KIQ{rYc4xjP7R6S~FF68xy$9p3QXJRMyY!X$}k`5q~PsVfyqT^^cGzDi>6$Q%M zVk3h%mK7XPld5Jgvbb~NlRrb7;f73_#u2WN3=IuQUnzQ!SQ`Z5O3WG3Bzmj*j2tOq zkw!CN9g$MxFp_RcV{n{E$Jna^M^VkBp)o(x5jr<(phB~$s*;k5gd%@MMCu=sMnE`P zg_k+Ayiz$78jhC2d7Mr~C!kPqj-WxU#UtE2Q_BPegJYyywk?5Wb6OYO4` zhSSg!OqFzz>J=x3O1R#t1Q;-_U+1c1)?GJ;WiH4Dd0Jc!G1R0!k=16XQOujTImfmR z_D4y>tWb>DSjJ%)yBZQ#mGqqDRK=EYn517y6rFZ2W4rW8oHMX!kyjE@?=%|>*UFr3 z83HHh+S#YSD9$7fe!1HL*2Li|zNWqOC>1|IU#1_)tng`bJJS;$I$ELRa51t}w`{O* zMR8d$v$@7-n3VWSR4ExaY}U3fQ)j;wG;%&hyQu1~0P2qPS ze{YJKaMMF^HBq=JTm_{1vD~wxW@%0^LKZo5*`tVWJ3V|;%)>1>HZyoq&h7%&<;J-b zshSyMH{!CQ!9yp3ONfXcZeDnE4Z9T}a`L(DKt+BPJ+gDe4w7s5v|;E*#AkbxY15$j z8YU95V_3&9XJ~HN$FtmPcMZR0x~qmm%U;>d4}oSrgX9;p!as#uUq8DT-f_n&gbyuT z`zU;9xw-9kZ@zx>kG_6y>)}QGH6Q+D==El&`I7zdLck2OKc zpKpqcJK*$ghvRspXaXv1Zq@w42(Uh@{59G%$ss>0eA2d~5Z=KC5^1h>C6Ezf2c`|O zd91uaX04%9LUrvrE?YUViJgoDCBza2QP6I5=$lm2>3BRM8hJn&SAT`mnNE7PO!HJg zb$$VR(f1_m#X+I2i5#UJA8h)t<1e22SGY$zR=qB8r4HWG`QAH+7Q1$@lIQe(oe=I^ z?$~%MxZ?8#6XL?Q6@lI#wDb3e9skCDuY|?m&iTnZ*A}-#e=Z=u+K!4`ho{k0C`Pmp z^sK&yq}m)Mi(d7sP=a`XOs!YEgTMnk0C=zr?sMP`fQQQ9eg_@~9I8>VojL}uSDVyk zN4W|>Rcgt5B0*y-x|sQUSMoFa)loVmW{aBIHC1AVHw;tuV_eT=71NR35?llm@B;9q zE7`$vGO12OyO~n+*L4F<0b?RZE(TLdBqppxqL1Dxf2Y}RoE!t_Cy_`qFq{j?Np@1m z1`aE7PCykx?1mj)Cfw-KbvZ9V&!WSOkD{Lqtz5g}NBfvT%V11UqERwM33FH%WfUN^ zJlpWUx)adn1rbXGDFs0F^NmfGyOir-xRU7)#oO!3I<(^6FIh(#u4#p~N!5c^LM{lS zt%0$om9UFndVgcHMY5YcXr%^5Wh;3xFa9?#qJf^7{ajPV$uAYT2+O5QGpYfvgdt^g zEMWNpnbEOGfG-L2HL!Jg5`FW;E=MG=1|#^NCh5(ppQ_@kut) z)DBRhP{O8rnsSU6nJvqv%PcQiK<4q{V(v^0&yC#G57G%(h*#CvN#~ zU7g=vXxg$E*t+D~x!kk!3&U1?LH`zr#KFa`y$=NB`7me%w3~{LyAxJ-0#q&3$j7GE z6$O!p1QGMLNyy0K*k`4IK#q|_dF211GC5`@-_eF5W6hW-SZ$!s_{ZfQnI zJ(D4$(iL>v4&zQiQmWJ1xFH+NBMD?w=LRAis7$VsGd4L%vM^s#Z@BccLuG`eop&6x zFAJQ-=_ljS809We!WgxR_arKy3s|oPVyUDY6Ya2lGC7kh@WF=4G~MJc!;~^3-OaO=WVKvSTZ) zW+$vkPD3?15yeUZ#8)yR4IKlEWf3GIqy#KtVg6T!S7ScA~oHNWk<#+~l(<>q%Uw(R)W$5keV{+MajgWg@5u?q*~G?Q<9 zE}9L3X7Y`7XjUv3GrmPrui_sXhe65zrOaWR zGBM8)NuF9*#JOrf;mT5-8dAfKQdAG6s1a-yFt!0@<~Cyp+|4MX7mJr95+(MKK#?+@ zT033BK3DhPL2<3qsI<=JtwnfJf z`XUmr4a3R6_^YP25Js~_MWGFcj!7c0s3;tN{rLO~ACaoCdA{S1w|;l)Qd{JsaD;RP z6cs`{%L|sm5jy;LIfwsnc(_T7G}V-;YNbVtam>&atZC(7@3y^Vn=@7QI9U zsu#^!$q1&yXz0$dw`VwI;1=1y@VKU2m9ssBfsN%FcO=Q!EbGWvN-#5~h^TOj~+}G@EH1!-4lwn{eWiW46bdfx)?+_F;Q5 zeZvP9GB#4ec1qO|LJY>Ztcx}T849!^8gQa+7J^N;l5>aV2NyaDP5q03=*PY&XK<>N z#DDSeI=M%P3fn&1IkeTq` zDw)WrN7^3lI4aE3nlnjFWIT>iS-i@S-7z1RBD%LYFpW$S|lE5Jxmca&?x88ETugi?skr$#I`S zJz_ts1)Zy1M7U9j=J_3#1U31Zo*(=}19sz!*U7DtonGtEn-Ht*Slo0C@CarsNLRXy9jGc#L4qX`#VfqMsa!UB zL~^e`lMp7`l zap4$Uma4LuId-md)RhH7d890n z7%|zUXGHT#LGn*%2^9$288dc~fHPE9HCopY* zqS0R58KCH-PEOCFSJJuYGXXUPo(B@~5dOFfq@=M|`K28BnvO-J9gMxkBpeGc!w8i# z;|g{rLXuH7DFkHQi0nljs!>UBaVN+mu2>a2!Np}d8g$+pg2|2)C=t3(VjFin&!*3= z!;=7^n_&q~N;c~RTYETlQAWXRG=M`T$u%C3ZiqJ2!|)h>v0wH*5E#IV~tSl zpuT{XXo)6MnlV>N5K%YzaR_ImdV@UB5QV*v5 z2~5bc>gTF!otG7S58pi2Zufh*;qiUnMWGb6tBq$hxXsn_J(rb|K(BgI9`_3t<5x;C z$J+f|ZKkCS*FY$D%+Pd#;jdT=l$- zgN~je750A4@z>;ttDAYN%p(**Bh@ zzq+t{DRl6Iu8%?|mp69Z&c2box3Pb5V}D^obU}XC_kQrb;KJ8F7%sFA6~aTGgf`46 zx3xF4w|3m?*|*rU@6S))JMjGCf#(a|qaTOPebOo2>G(nCo1OQ%_b+zue>e7F$5Q8+ zLio(B5hS0kZ9cg0>mPJ~aO$r{{$k|b;Mn5eSmEgTzkapQ{z4)ALaDEgw~{}YdUI;2 zd*8>Q{p$_#-rh5dd(RXG&VGpc=x$`WZR73e8_|1hk;S%1p>_8{_rj@nM(&Q>>l<3^ z8!GHM{=ut-=HWtMm>Febk%pRvU_C7(C>Jp z>lBd!8Mu7rgA(Y+XL9tpQ$4%a?}Zx7I1|^Kk;V5^TsW5tT@tiRIPXM;1sR>|*_!_Bw6Jx`R-x(@2cNYTP z&T6djao1XiAE1fqHF%3)l%%K=n$Nd{PaE2*i7)zl=1@oIIF9S#_mWxP8&m-9Jtc96xOFit+BuD=xcB;}hXO2+~ zy%&aAZ=}z?9uEx*3I|LSW>Q-CBFi!TufxLUt`sQAN%DknrGuI++Dg4-h+4yq~C= z1`*H>xSl}fslr#U?6#=kM;Vt}Y~wJuE_3jbUSotPp_n=gv)N(y6HEGF)^6oZ#7Q+~ zM!adX5NazW%zI3yzwyUN?11}yDsz$9_0PW;KR-75lI_1Zdj8Ty`k;bsf8%MYK|wYi zc0NtH=O|$z=1Y`|Q9>SEcGaIdr&;8k1>L)-U@IjOCEb+tP_m7Z?Uc+>LL!uHe=emL z@RJTuX4DuY4d@rM$c$aiFQ#AH^^Qqqkk~fvu(As@lYg*kLf8J0pw%->h z=@2}jMNyjDUJ#}E9mqZK0DSAoRVrQe3ZCv20{s8NTfz9+A9(hPJLe`>1-xiT?JESh zkF$oxzK6!XXMPuwJD2hEfoFrb<<{3%1-uBmZ-oH&_pY62gZT6uCW@CcQRMD-t;MSo zciy_PD&XbdA$Py+i{mwmyKfDw3V1o~A$NcK+V&d7fm=6M1-u+Q77^Z zzOuCKXko+A#n9kvU|Be~+_Y&v{HFGv_uW(PpL_4z(%utGJ5LripImG@H5*zMPA>;q z=lU?C?eFZqyL(AGSZF)A7&tWRUlvX|t=_%(ZpZsw?{&Q$U)px8u;JKZXoy-qzl_P= zeDkFR>z$dqGfO*;6gC}MY&<&KKt(N`^L=-N?`?ZmdH?ErSO08asrN*o>%?Nq$=Swb z;l&l-W^w0FebIt1`itfIwtp2iiaY}iY=*G=u_ zs^ZmM#nkOx;6ha(Qsq!`>m+4WCaJAjE|sbyySdvp)6}`wo4xE+?#`v^{%}w4YIpy+ z`@Zh!>6xLyF_qlCs(JnT{rG%;zaRAD=h@i|0qMU_{o1vmfFQocFKRNz3QrcG@D9Ne zEa@R^%9FH_@J@Lsufb;UQZ~v<+i0)RW+ZXD!IR<5v}MX=+GFyXZDucHW4u|mEbkiI z8gI5O+q>4b)@!j@yz6Z1NP;7WOH{JjlQmwZ2!hW9#0*cacfD;rN%%74H*X+eX&RWpNupEW$~#%p0_A({<9CwS=2Ht+Yh54uO+QI2YVr zPBP=1op@3YHSZ7{f%R;o zdO=Q`fulJiOW_tSgQKxr@NP(Xr}6uBqcuaKTO0vytc)p!)Kn~R0ik#hYKonHzW9bqCmr+zpZ%_4WMg9NCD40*f6}uDoOfd$$F0+S$ zrP4sxvxgpfsy#ATV;bms_Rv93&}e%0Na~d^`v1!w`Fi%4+oaBe&$X)S*;^N%&7Ui{ z7u##ZD7?UKPQxmCHrJy-v!=Pi6bf6|t!Yruv%3z31k0^tQCuI7m${;3Zc@gl5pO9Y zv=ulxLP=FdS2{7IXR#M_Jc5}kPVtCsY>7%~m0gRTz4Y+uW%%3K9ckbfs=Oxb^zi;S zC4n81cd0M3JHH`%aSAlNenWJ;otKjkw*uZlKc6Hng5C8#33=)JBx`b!Z2lM=jhzOl z!EYwk?4q3M?8u+ZO|imlVxB7bx5ka0U3Vl>R?5p(4lDc8w`kYhfS)`|rH8NSGA>7o zWz&!abXmskaZ&Irf1h+3*fOx^UTj^qB5vn&V*J_M6zgbqne5*hKXIKTc)A`347)c) z`;~0fw`g4kyf@jp)oe`~_&Zf?X>qHSV&@Ux2(x6M=r~- zBwIR3yV8l@(&b#G_*~kY3{gV_TYHCeQo?Q(^fEN! zQ>rwoM!!vNSLf!tmLyd|p;EPuuumc?+KGbJ|<?asull_WY^o()vCJHp6rpiCRLKyF29*=QF&b!6&dQt;X1XXJ%#wH zA^(-Jl|3r2jBW3)9Az5bK@CSOrQjW7kIQ)NY2nqYDB3dxZ=DP8$zDzitwBRkOQ~q= z37NZ&Rq$df8SEe9yUB$0^@xhBJ=v3Qq|AZ9ai_eOJhciPO{>ismRb_xo*`T5G|Zl@ zYTIy|TGE~gt;e-mwX}L`7O~2@sB!tSil#l2xlEw)+#I?n7GzArqdPR}YUz2nfc@U- z1U_|iwaRHv(?zFBTYDyR@oXvyT%9E)ru)KGX0EJzZ##9FL}FL~>VZB+ENLE%KhFMV9eHnu+PW_ux~&$8!I zeds#zH-=Y9YhULQ7RhQ@!XKcQFdIw1h3}$P178AV9!tLTKad_l0n%?8t@NX6Iep#u z$SJ3PZ+!IE6F4n3KKlDFaQcr%7{3d;$3{Ux>GAPT-3X2nOZbl$OBkD92bud9xDIbX zmWm)7Ggg*YR#lH>$d5|N051|*VKpi&;g5a%4xGJ+Gt8!yk{RW9;<8bu%$MRuE6!fR z8Q%C?4KX(UsgWKSi=4ZSa@3{Q62$`abhZUye&`&%k0Y(DHzPb z04^rAOpM2ybSvfRf9uo#D((MD)zR-7V+8mExSf=;yrUk$4d1WrekY8ND}~1&cAx^o z@OyD4OG+y}cHs)#^ay^Ceve^mpupq30Sv=id5H$i)kw^>c(NKKLLw_AsN{V3E*pb=(FoSW(KgtKjvX74P{t<3(hu_EgeNa#1kLwcY#l=yd zTlEQ-;^^y+fKI4=-Z8qSyvi#X90P+=hSTpKaPUAC3oDUL65Z_gLt|5O3*2Wo+IGrH zD|*2C;=6DsL(@QuI)HKvNVKDJplU1=kcwrfQ5>D0-l?pp7{ww#esBCwNAbq{)gidl zaFyeWAHVnZ>w~dB2|_(VU_V+9zbE(`*gG&Wu;ds-H%ncHz~}~@bSi3;{SB*UmXyeA z0Sr;h<0zC&^&W?JfORyCZIW*#l-GOwgAPxi0SZdP520HChwbY`s4JZFL2uacp-ui= z53n%~B}P4+7sRIVQ%`TzH}2 z!b`?=gO&c{&J<;xyxuYz5d7X_ynl3rV^4B|11`Zh_+l8CBs(Tu4L|udO6o<1VXV%S z#FE-FsT@9HlRDM83|MvrJU=Afj)2u7<}$;o+zBMql?0rH?8Kq(^!OccKG^MA2a=RTaj_`K-a=-dZ;39yhzt@Sm4Z$n-@*i63Bi8ywYlGrk5OTnX`83b5 z?m-9u9Gd~o<4kY~d|^g`AKUw!{QL-0$6v;NOZ@(I;>+B;cgo%_ixf48xsBqQ#yIz0t_yW1O{2xnzUGUNV58WPT*- zm>@ekkGbcuwfRikgE|HaSBC&Ue76eB%EQGYi8&ctlTJA$LqOoAjFWC(2j`OvknuP+ zp~i6yzu+5I{90UN2yg9hwg+0>E@*~AQ((~TmUReB1=`#&ij!!sLl}|_J_oP?Gq;r09_aK7u|^}jKm+uK zI$UDf1MNPiGBR7PjlUY;mXu^kiAPu+uvQaY$S6Aw|0Yypn*{z5!e91@e`VJG+4afw zlLPN@6WmnOyF=q!B9>jj!qAw=G)L*?FXi?PGt^zkTV#5o zbPsg-(vziryRi?ar16uDqGev5G)Zl??I;WRVeHV?n*{qcROD+zc6`h>gca-0V?-QBxQTqIMuG1B` z3~oYItAKVe5Le1i~{b)6xc(yKsFNFG^;hwUlM9DL=3JCMm*5vCCQi)Ng<8Yg!d>F-#?Ou~ z^q}q@boQLs+P7GE9_5~om~1Qazj8~0WC>2)MPE;KNN`rINj9HoboQQD^4f|YmLQNf;wrToK!PdXMV7q+9* zXFe}Q72W7;AG*+wY!}fb2L`fpsMjent|;x&Ce0*qg8k@Fr^uX&(x+0y(L`R>M^~ay zb9jB&6<+%@3##rz{dRN#%M!W3BG)i-UPiu=h;szlu80gDrFk8pH03-WlqQ*M290mD z2O?@fWCo-3;L5`Fg>H&WTa<27a6q=1>hYn8t#i5eH_mPhk)g_ag{WX(#8MmXny>u0 zFuZmlcfoON~nJ-v&qXT?M37K{3j>3l-0CoZy>UyE2+hjQy8rUP-TnZ7x9n7rqiFIs%DYteiL znY!a`Y13J!%msKykvW|i>|QLcL0{WcNv%7l_C~8;)}~tit+88UliP27e`>>2X4DFEXML2eSBAw~f@V}) z6|Fg|OstyYdnP=Q-HqbbBdFj=#M1QXfuF(Lfu|_kg@5a{Tdz%m18W%lo_hzs;XFquoi2+`M&jl8ab&%m{a{O<#ME_fh@_`Do|Ca8DS7X^GM; z3Rl-|U7IxC`u(e`SEc*rI) zN22r*rQ7#zeQ&ZiV%a{!-W{4AnzB9E@lojqrQudo*`%$S{6kAo#8Nb4j97Ng<=xMp z%@5U}(z>72{Iu@ly6{WN9zgbD5E>(%pBbGSxbKXv8~;E?gCvSEKZ+3Y@at#Pf?y+*+Yb;UPJY z!&M^F5TzTQW>Cf><~3uD*3A$)vZSm>U=4C|3dpZP-o z@6&&9HSg+1(wfiTgcsP&Uk@Z47V!36+0AFN%717m=Z6gVhX%LLCI8ETau&d6WaS`) z&j~#KD}{VMP>u#`;Expn_|CqVplqDH5H(F=RY6tdAJh x-*!d~h5t Iterable[Case]: + # Gt, Ge, Lt, Le + yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1)) + yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1)) + yield Case( + Annotated[datetime, at.Gt(datetime(2000, 1, 1))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(2000, 1, 1), datetime(1999, 12, 31)], + ) + yield Case( + Annotated[datetime, at.Gt(date(2000, 1, 1))], + [date(2000, 1, 2), date(2000, 1, 3)], + [date(2000, 1, 1), date(1999, 12, 31)], + ) + yield Case( + Annotated[datetime, at.Gt(Decimal('1.123'))], + [Decimal('1.1231'), Decimal('123')], + [Decimal('1.123'), Decimal('0')], + ) + + yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1)) + yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1)) + yield Case( + Annotated[datetime, at.Ge(datetime(2000, 1, 1))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(1998, 1, 1), datetime(1999, 12, 31)], + ) + + yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4)) + yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9)) + yield Case( + Annotated[datetime, at.Lt(datetime(2000, 1, 1))], + [datetime(1999, 12, 31), datetime(1999, 12, 31)], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + ) + + yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000)) + yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9)) + yield Case( + Annotated[datetime, at.Le(datetime(2000, 1, 1))], + [datetime(2000, 1, 1), datetime(1999, 12, 31)], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + ) + + # Interval + yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1)) + yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1)) + yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1)) + yield Case( + Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))], + [datetime(2000, 1, 2), datetime(2000, 1, 3)], + [datetime(2000, 1, 1), datetime(2000, 1, 4)], + ) + + yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4)) + yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1)) + + # lengths + + yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12')) + yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12')) + yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2])) + yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2])) + + yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10)) + yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10)) + yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10)) + yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10)) + + yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10)) + yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234')) + + yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}]) + yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4})) + yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4))) + + # Timezone + + yield Case( + Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)] + ) + yield Case( + Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)] + ) + yield Case( + Annotated[datetime, at.Timezone(timezone.utc)], + [datetime(2000, 1, 1, tzinfo=timezone.utc)], + [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))], + ) + yield Case( + Annotated[datetime, at.Timezone('Europe/London')], + [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))], + [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))], + ) + + # Quantity + + yield Case(Annotated[float, at.Unit(unit='m')], (5, 4.2), ('5m', '4.2m')) + + # predicate types + + yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom']) + yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC']) + yield Case(at.IsDigit[str], ['123'], ['', 'ab', 'a1b2']) + yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀']) + + yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5]) + + yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf]) + yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23]) + yield Case(at.IsNan[float], [math.nan], [1.23, math.inf]) + yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan]) + yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23]) + yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf]) + + # check stacked predicates + yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan]) + + # doc + yield Case(Annotated[int, at.doc("A number")], [1, 2], []) + + # custom GroupedMetadata + class MyCustomGroupedMetadata(at.GroupedMetadata): + def __iter__(self) -> Iterator[at.Predicate]: + yield at.Predicate(lambda x: float(x).is_integer()) + + yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5]) diff --git a/.venv/Lib/site-packages/anyio-4.9.0.dist-info/INSTALLER b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/anyio-4.9.0.dist-info/LICENSE b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/LICENSE new file mode 100644 index 0000000..104eebf --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/LICENSE @@ -0,0 +1,20 @@ +The MIT License (MIT) + +Copyright (c) 2018 Alex Grönholm + +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/.venv/Lib/site-packages/anyio-4.9.0.dist-info/METADATA b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/METADATA new file mode 100644 index 0000000..9d87e1d --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/METADATA @@ -0,0 +1,105 @@ +Metadata-Version: 2.2 +Name: anyio +Version: 4.9.0 +Summary: High level compatibility layer for multiple asynchronous event loop implementations +Author-email: Alex Grönholm +License: MIT +Project-URL: Documentation, https://anyio.readthedocs.io/en/latest/ +Project-URL: Changelog, https://anyio.readthedocs.io/en/stable/versionhistory.html +Project-URL: Source code, https://github.com/agronholm/anyio +Project-URL: Issue tracker, https://github.com/agronholm/anyio/issues +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Framework :: AnyIO +Classifier: Typing :: Typed +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 +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: exceptiongroup>=1.0.2; python_version < "3.11" +Requires-Dist: idna>=2.8 +Requires-Dist: sniffio>=1.1 +Requires-Dist: typing_extensions>=4.5; python_version < "3.13" +Provides-Extra: trio +Requires-Dist: trio>=0.26.1; extra == "trio" +Provides-Extra: test +Requires-Dist: anyio[trio]; extra == "test" +Requires-Dist: blockbuster>=1.5.23; extra == "test" +Requires-Dist: coverage[toml]>=7; extra == "test" +Requires-Dist: exceptiongroup>=1.2.0; extra == "test" +Requires-Dist: hypothesis>=4.0; extra == "test" +Requires-Dist: psutil>=5.9; extra == "test" +Requires-Dist: pytest>=7.0; extra == "test" +Requires-Dist: trustme; extra == "test" +Requires-Dist: truststore>=0.9.1; python_version >= "3.10" and extra == "test" +Requires-Dist: uvloop>=0.21; (platform_python_implementation == "CPython" and platform_system != "Windows" and python_version < "3.14") and extra == "test" +Provides-Extra: doc +Requires-Dist: packaging; extra == "doc" +Requires-Dist: Sphinx~=8.2; extra == "doc" +Requires-Dist: sphinx_rtd_theme; extra == "doc" +Requires-Dist: sphinx-autodoc-typehints>=1.2.0; extra == "doc" + +.. image:: https://github.com/agronholm/anyio/actions/workflows/test.yml/badge.svg + :target: https://github.com/agronholm/anyio/actions/workflows/test.yml + :alt: Build Status +.. image:: https://coveralls.io/repos/github/agronholm/anyio/badge.svg?branch=master + :target: https://coveralls.io/github/agronholm/anyio?branch=master + :alt: Code Coverage +.. image:: https://readthedocs.org/projects/anyio/badge/?version=latest + :target: https://anyio.readthedocs.io/en/latest/?badge=latest + :alt: Documentation +.. image:: https://badges.gitter.im/gitterHQ/gitter.svg + :target: https://gitter.im/python-trio/AnyIO + :alt: Gitter chat + +AnyIO is an asynchronous networking and concurrency library that works on top of either asyncio_ or +trio_. It implements trio-like `structured concurrency`_ (SC) on top of asyncio and works in harmony +with the native SC of trio itself. + +Applications and libraries written against AnyIO's API will run unmodified on either asyncio_ or +trio_. AnyIO can also be adopted into a library or application incrementally – bit by bit, no full +refactoring necessary. It will blend in with the native libraries of your chosen backend. + +Documentation +------------- + +View full documentation at: https://anyio.readthedocs.io/ + +Features +-------- + +AnyIO offers the following functionality: + +* Task groups (nurseries_ in trio terminology) +* High-level networking (TCP, UDP and UNIX sockets) + + * `Happy eyeballs`_ algorithm for TCP connections (more robust than that of asyncio on Python + 3.8) + * async/await style UDP sockets (unlike asyncio where you still have to use Transports and + Protocols) + +* A versatile API for byte streams and object streams +* Inter-task synchronization and communication (locks, conditions, events, semaphores, object + streams) +* Worker threads +* Subprocesses +* Asynchronous file I/O (using worker threads) +* Signal handling + +AnyIO also comes with its own pytest_ plugin which also supports asynchronous fixtures. +It even works with the popular Hypothesis_ library. + +.. _asyncio: https://docs.python.org/3/library/asyncio.html +.. _trio: https://github.com/python-trio/trio +.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency +.. _nurseries: https://trio.readthedocs.io/en/stable/reference-core.html#nurseries-and-spawning +.. _Happy eyeballs: https://en.wikipedia.org/wiki/Happy_Eyeballs +.. _pytest: https://docs.pytest.org/en/latest/ +.. _Hypothesis: https://hypothesis.works/ diff --git a/.venv/Lib/site-packages/anyio-4.9.0.dist-info/RECORD b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/RECORD new file mode 100644 index 0000000..971925e --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/RECORD @@ -0,0 +1,88 @@ +anyio-4.9.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +anyio-4.9.0.dist-info/LICENSE,sha256=U2GsncWPLvX9LpsJxoKXwX8ElQkJu8gCO9uC6s8iwrA,1081 +anyio-4.9.0.dist-info/METADATA,sha256=vvkWPXXTbrpTCFK7zdcYwQcSQhx6Q4qITM9t_PEQCrY,4682 +anyio-4.9.0.dist-info/RECORD,, +anyio-4.9.0.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91 +anyio-4.9.0.dist-info/entry_points.txt,sha256=_d6Yu6uiaZmNe0CydowirE9Cmg7zUL2g08tQpoS3Qvc,39 +anyio-4.9.0.dist-info/top_level.txt,sha256=QglSMiWX8_5dpoVAEIHdEYzvqFMdSYWmCj6tYw2ITkQ,6 +anyio/__init__.py,sha256=t8bZuNXa5ncwXBaNKbv48BDgZt48RT_zCEtrnPmjNU8,4993 +anyio/__pycache__/__init__.cpython-312.pyc,, +anyio/__pycache__/from_thread.cpython-312.pyc,, +anyio/__pycache__/lowlevel.cpython-312.pyc,, +anyio/__pycache__/pytest_plugin.cpython-312.pyc,, +anyio/__pycache__/to_interpreter.cpython-312.pyc,, +anyio/__pycache__/to_process.cpython-312.pyc,, +anyio/__pycache__/to_thread.cpython-312.pyc,, +anyio/_backends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +anyio/_backends/__pycache__/__init__.cpython-312.pyc,, +anyio/_backends/__pycache__/_asyncio.cpython-312.pyc,, +anyio/_backends/__pycache__/_trio.cpython-312.pyc,, +anyio/_backends/_asyncio.py,sha256=AT1oaTfCE-9YFxooMlvld2yDqY5U2A-ANMcBDh9eRfI,93455 +anyio/_backends/_trio.py,sha256=HVfDqRGQ7Xj3JfTcYdgzmC7pZEplqU4NOO5kxNNSZnk,40429 +anyio/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +anyio/_core/__pycache__/__init__.cpython-312.pyc,, +anyio/_core/__pycache__/_asyncio_selector_thread.cpython-312.pyc,, +anyio/_core/__pycache__/_eventloop.cpython-312.pyc,, +anyio/_core/__pycache__/_exceptions.cpython-312.pyc,, +anyio/_core/__pycache__/_fileio.cpython-312.pyc,, +anyio/_core/__pycache__/_resources.cpython-312.pyc,, +anyio/_core/__pycache__/_signals.cpython-312.pyc,, +anyio/_core/__pycache__/_sockets.cpython-312.pyc,, +anyio/_core/__pycache__/_streams.cpython-312.pyc,, +anyio/_core/__pycache__/_subprocesses.cpython-312.pyc,, +anyio/_core/__pycache__/_synchronization.cpython-312.pyc,, +anyio/_core/__pycache__/_tasks.cpython-312.pyc,, +anyio/_core/__pycache__/_tempfile.cpython-312.pyc,, +anyio/_core/__pycache__/_testing.cpython-312.pyc,, +anyio/_core/__pycache__/_typedattr.cpython-312.pyc,, +anyio/_core/_asyncio_selector_thread.py,sha256=2PdxFM3cs02Kp6BSppbvmRT7q7asreTW5FgBxEsflBo,5626 +anyio/_core/_eventloop.py,sha256=t_tAwBFPjF8jrZGjlJ6bbYy6KA3bjsbZxV9mvh9t1i0,4695 +anyio/_core/_exceptions.py,sha256=RlPRlwastdmfDPoskdXNO6SI8_l3fclA2wtW6cokU9I,3503 +anyio/_core/_fileio.py,sha256=qFZhkLIz0cGXluvih_vcPUTucgq8UFVgsTCtYbijZIg,23340 +anyio/_core/_resources.py,sha256=NbmU5O5UX3xEyACnkmYX28Fmwdl-f-ny0tHym26e0w0,435 +anyio/_core/_signals.py,sha256=vulT1M1xdLYtAR-eY5TamIgaf1WTlOwOrMGwswlTTr8,905 +anyio/_core/_sockets.py,sha256=5Okc_UThGDEN9KCnsIhqWPRHBNuSy6b4NmG1i51TVF4,27150 +anyio/_core/_streams.py,sha256=OnaKgoDD-FcMSwLvkoAUGP51sG2ZdRvMpxt9q2w1gYA,1804 +anyio/_core/_subprocesses.py,sha256=EXm5igL7dj55iYkPlbYVAqtbqxJxjU-6OndSTIx9SRg,8047 +anyio/_core/_synchronization.py,sha256=DwUh8Tl6cG_UMVC_GyzPoC_U9BpfDfjMl9SINSxcZN4,20320 +anyio/_core/_tasks.py,sha256=f3CuWwo06cCZ6jaOv-JHFKWkgpgf2cvaF25Oh4augMA,4757 +anyio/_core/_tempfile.py,sha256=s-_ucacXbxBH5Bo5eo65lN0lPwZQd5B8yNN_9nARpCM,19696 +anyio/_core/_testing.py,sha256=YUGwA5cgFFbUTv4WFd7cv_BSVr4ryTtPp8owQA3JdWE,2118 +anyio/_core/_typedattr.py,sha256=P4ozZikn3-DbpoYcvyghS_FOYAgbmUxeoU8-L_07pZM,2508 +anyio/abc/__init__.py,sha256=c2OQbTCS_fQowviMXanLPh8m29ccwkXmpDr7uyNZYOo,2652 +anyio/abc/__pycache__/__init__.cpython-312.pyc,, +anyio/abc/__pycache__/_eventloop.cpython-312.pyc,, +anyio/abc/__pycache__/_resources.cpython-312.pyc,, +anyio/abc/__pycache__/_sockets.cpython-312.pyc,, +anyio/abc/__pycache__/_streams.cpython-312.pyc,, +anyio/abc/__pycache__/_subprocesses.cpython-312.pyc,, +anyio/abc/__pycache__/_tasks.cpython-312.pyc,, +anyio/abc/__pycache__/_testing.cpython-312.pyc,, +anyio/abc/_eventloop.py,sha256=UmL8DZCvQTgxzmyBZcGm9kWj9VQY8BMWueLh5S8yWN4,9682 +anyio/abc/_resources.py,sha256=DrYvkNN1hH6Uvv5_5uKySvDsnknGVDe8FCKfko0VtN8,783 +anyio/abc/_sockets.py,sha256=KhWtJxan8jpBXKwPaFeQzI4iRXdFaOIn0HXtDZnaO7U,6262 +anyio/abc/_streams.py,sha256=He_JpkAW2g5veOzcUq0XsRC2nId_i35L-d8cs7Uj1ZQ,6598 +anyio/abc/_subprocesses.py,sha256=cumAPJTktOQtw63IqG0lDpyZqu_l1EElvQHMiwJgL08,2067 +anyio/abc/_tasks.py,sha256=yJWbMwowvqjlAX4oJ3l9Is1w-zwynr2lX1Z02AWJqsY,3080 +anyio/abc/_testing.py,sha256=tBJUzkSfOXJw23fe8qSJ03kJlShOYjjaEyFB6k6MYT8,1821 +anyio/from_thread.py,sha256=MbXHZpgM9wgsRkbGhMNMomEGYj7Y_QYq6a5BZ3c5Ev8,17478 +anyio/lowlevel.py,sha256=nkgmW--SdxGVp0cmLUYazjkigveRm5HY7-gW8Bpp9oY,4169 +anyio/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +anyio/pytest_plugin.py,sha256=qXNwk9Pa7hPQKWocgLl9qijqKGMkGzdH2wJa-jPkGUM,9375 +anyio/streams/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +anyio/streams/__pycache__/__init__.cpython-312.pyc,, +anyio/streams/__pycache__/buffered.cpython-312.pyc,, +anyio/streams/__pycache__/file.cpython-312.pyc,, +anyio/streams/__pycache__/memory.cpython-312.pyc,, +anyio/streams/__pycache__/stapled.cpython-312.pyc,, +anyio/streams/__pycache__/text.cpython-312.pyc,, +anyio/streams/__pycache__/tls.cpython-312.pyc,, +anyio/streams/buffered.py,sha256=UCldKC168YuLvT7n3HtNPnQ2iWAMSTYQWbZvzLwMwkM,4500 +anyio/streams/file.py,sha256=6uoTNb5KbMoj-6gS3_xrrL8uZN8Q4iIvOS1WtGyFfKw,4383 +anyio/streams/memory.py,sha256=o1OVVx0OooteTTe2GytJreum93Ucuw5s4cAsr3X0-Ag,10560 +anyio/streams/stapled.py,sha256=U09pCrmOw9kkNhe6tKopsm1QIMT1lFTFvtb-A7SIe4k,4302 +anyio/streams/text.py,sha256=6x8w8xlfCZKTUWQoJiMPoMhSSJFUBRKgoBNSBtbd9yg,5094 +anyio/streams/tls.py,sha256=HxzpVmUgo8SUSIBass_lvef1pAI1uRSrnysM3iEGzl4,13199 +anyio/to_interpreter.py,sha256=UhuNCIucCRN7ZtyJg35Mlamzs1JpgDvK4xnL4TDWrAo,6527 +anyio/to_process.py,sha256=ZvruelRM-HNmqDaql4sdNODg2QD_uSlwSCxnV4OhsfQ,9595 +anyio/to_thread.py,sha256=WM2JQ2MbVsd5D5CM08bQiTwzZIvpsGjfH1Fy247KoDQ,2396 diff --git a/.venv/Lib/site-packages/anyio-4.9.0.dist-info/WHEEL b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/WHEEL new file mode 100644 index 0000000..9c3ae63 --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (76.0.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/.venv/Lib/site-packages/anyio-4.9.0.dist-info/entry_points.txt b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/entry_points.txt new file mode 100644 index 0000000..44dd9bd --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/entry_points.txt @@ -0,0 +1,2 @@ +[pytest11] +anyio = anyio.pytest_plugin diff --git a/.venv/Lib/site-packages/anyio-4.9.0.dist-info/top_level.txt b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/top_level.txt new file mode 100644 index 0000000..c77c069 --- /dev/null +++ b/.venv/Lib/site-packages/anyio-4.9.0.dist-info/top_level.txt @@ -0,0 +1 @@ +anyio diff --git a/.venv/Lib/site-packages/anyio/__init__.py b/.venv/Lib/site-packages/anyio/__init__.py new file mode 100644 index 0000000..578cda6 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/__init__.py @@ -0,0 +1,85 @@ +from __future__ import annotations + +from ._core._eventloop import current_time as current_time +from ._core._eventloop import get_all_backends as get_all_backends +from ._core._eventloop import get_cancelled_exc_class as get_cancelled_exc_class +from ._core._eventloop import run as run +from ._core._eventloop import sleep as sleep +from ._core._eventloop import sleep_forever as sleep_forever +from ._core._eventloop import sleep_until as sleep_until +from ._core._exceptions import BrokenResourceError as BrokenResourceError +from ._core._exceptions import BrokenWorkerIntepreter as BrokenWorkerIntepreter +from ._core._exceptions import BrokenWorkerProcess as BrokenWorkerProcess +from ._core._exceptions import BusyResourceError as BusyResourceError +from ._core._exceptions import ClosedResourceError as ClosedResourceError +from ._core._exceptions import DelimiterNotFound as DelimiterNotFound +from ._core._exceptions import EndOfStream as EndOfStream +from ._core._exceptions import IncompleteRead as IncompleteRead +from ._core._exceptions import TypedAttributeLookupError as TypedAttributeLookupError +from ._core._exceptions import WouldBlock as WouldBlock +from ._core._fileio import AsyncFile as AsyncFile +from ._core._fileio import Path as Path +from ._core._fileio import open_file as open_file +from ._core._fileio import wrap_file as wrap_file +from ._core._resources import aclose_forcefully as aclose_forcefully +from ._core._signals import open_signal_receiver as open_signal_receiver +from ._core._sockets import connect_tcp as connect_tcp +from ._core._sockets import connect_unix as connect_unix +from ._core._sockets import create_connected_udp_socket as create_connected_udp_socket +from ._core._sockets import ( + create_connected_unix_datagram_socket as create_connected_unix_datagram_socket, +) +from ._core._sockets import create_tcp_listener as create_tcp_listener +from ._core._sockets import create_udp_socket as create_udp_socket +from ._core._sockets import create_unix_datagram_socket as create_unix_datagram_socket +from ._core._sockets import create_unix_listener as create_unix_listener +from ._core._sockets import getaddrinfo as getaddrinfo +from ._core._sockets import getnameinfo as getnameinfo +from ._core._sockets import wait_readable as wait_readable +from ._core._sockets import wait_socket_readable as wait_socket_readable +from ._core._sockets import wait_socket_writable as wait_socket_writable +from ._core._sockets import wait_writable as wait_writable +from ._core._streams import create_memory_object_stream as create_memory_object_stream +from ._core._subprocesses import open_process as open_process +from ._core._subprocesses import run_process as run_process +from ._core._synchronization import CapacityLimiter as CapacityLimiter +from ._core._synchronization import ( + CapacityLimiterStatistics as CapacityLimiterStatistics, +) +from ._core._synchronization import Condition as Condition +from ._core._synchronization import ConditionStatistics as ConditionStatistics +from ._core._synchronization import Event as Event +from ._core._synchronization import EventStatistics as EventStatistics +from ._core._synchronization import Lock as Lock +from ._core._synchronization import LockStatistics as LockStatistics +from ._core._synchronization import ResourceGuard as ResourceGuard +from ._core._synchronization import Semaphore as Semaphore +from ._core._synchronization import SemaphoreStatistics as SemaphoreStatistics +from ._core._tasks import TASK_STATUS_IGNORED as TASK_STATUS_IGNORED +from ._core._tasks import CancelScope as CancelScope +from ._core._tasks import create_task_group as create_task_group +from ._core._tasks import current_effective_deadline as current_effective_deadline +from ._core._tasks import fail_after as fail_after +from ._core._tasks import move_on_after as move_on_after +from ._core._tempfile import NamedTemporaryFile as NamedTemporaryFile +from ._core._tempfile import SpooledTemporaryFile as SpooledTemporaryFile +from ._core._tempfile import TemporaryDirectory as TemporaryDirectory +from ._core._tempfile import TemporaryFile as TemporaryFile +from ._core._tempfile import gettempdir as gettempdir +from ._core._tempfile import gettempdirb as gettempdirb +from ._core._tempfile import mkdtemp as mkdtemp +from ._core._tempfile import mkstemp as mkstemp +from ._core._testing import TaskInfo as TaskInfo +from ._core._testing import get_current_task as get_current_task +from ._core._testing import get_running_tasks as get_running_tasks +from ._core._testing import wait_all_tasks_blocked as wait_all_tasks_blocked +from ._core._typedattr import TypedAttributeProvider as TypedAttributeProvider +from ._core._typedattr import TypedAttributeSet as TypedAttributeSet +from ._core._typedattr import typed_attribute as typed_attribute + +# Re-export imports so they look like they live directly in this package +for __value in list(locals().values()): + if getattr(__value, "__module__", "").startswith("anyio."): + __value.__module__ = __name__ + +del __value diff --git a/.venv/Lib/site-packages/anyio/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/anyio/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2a14cfe2250c5a54d6e0316fba6a60f8f2f42708 GIT binary patch literal 3601 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/__pycache__/lowlevel.cpython-312.pyc b/.venv/Lib/site-packages/anyio/__pycache__/lowlevel.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..21afeb439aa1353a7d40aa6279d6683e9c44459e GIT binary patch literal 6989 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/__pycache__/pytest_plugin.cpython-312.pyc b/.venv/Lib/site-packages/anyio/__pycache__/pytest_plugin.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2d8e0e404a5cec26091fd42078d79a5a876a2c96 GIT binary patch literal 13379 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%0ANmO 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 GcK!<=vtoMy literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/__pycache__/to_process.cpython-312.pyc b/.venv/Lib/site-packages/anyio/__pycache__/to_process.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b9e13d3c9cfb5ee23d27153c6d18ad5eb4f56e9a GIT binary patch literal 11814 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_backends/__init__.py b/.venv/Lib/site-packages/anyio/_backends/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/anyio/_backends/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_backends/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c5743ef8c1c9c7015011483303349e159a759fda GIT binary patch literal 213 zcmZ8bI|{-;5Y74lQ9Ou65?e)VY(>)84J?~vh^uCInO%jP#4~snZy;EC0!e4(r1inP z&oB({F`bSh#w2@HoxVHzM?2unEo!2f*xe)QacaApZ`dqh?~yzxU6S^YHN`O(dSc0>yJmkz$IVbDOX)%Z7islMiorBi_W2cIfs*wMgM%z^8oY9m%l~NlW cq)c4%9Ia|wUe36tA(s$5zB8Y`5Q6&betIC|4jIBV{u<`CglfZe{<`oI z{}T3X4Vl9A{`zo(zkz+{gc`#>zmK_Xp{8)Nzd79EZ(-l|(9&?Lzcswfzbw4mzdYRL zZ)5(sp%vkk{*}z_2wB3b{HvJT8Co4)<6pzvuF%@>I{!N6&I?(?>;3D)8~hvCcYeqg z-ss=R-0o0&c$0rqc(Z>q`}Tykgzxj;7w+(Pgtz*)hCBV8;Vyqyc$1ZShIjdQg?IaRhxhpRg!lUQhWGjRAx>eSIMf~9@82K3-+w>*E(tvl zKHxtPKIlIf?(z48AM`&Me#rk&_+kIUEW9-INcd6zqs(0v@`oSuKgQhUp~u6A{GVg) z3b=dyPcU~S+>D zP#1jKe=?YJ>=SuvtG|JUzP^*@Vzy5XY>$*bWx|8wknt$!_kTafCs|8)3_|4jI-|7`eq|MM(|rJ-}- zFZjP8<@Su4n~vMT1zOK>fn~wxF7U_fY8zzNxAmgS|3wyeIpVf`TPOLA1-=|uan9f$ z$L~t~PUyH`S76n*c`5t__Psi==B>3#nit`BDzHw8a~|KLf%VGwm+&nFHYnd;4r~m* z6xh&?ECVkE+EL1dz=gmj{9Z)N?cWxQ;{0C;Y(~5-EZ)VyeF*<*;46U+{JzX;z7;j^ z3=SymIm&#y;JZz!+t)I3d?m0QIqskwS=^n7yDPX4{nRQIn)ajQJ9(F}-Oa|fGN?!T z6=?}2Cwx~e_VvFO*n>Lkr8*4i0y_U|tS0+VlWta%b&Jy|HF-VwjbLZ+g%U);@4u(t zBRYEf-(b1yM=tjVH!AU`SkFJ8^!(+(0hIlK*nW)3K_%pyfgXe$RC?w?_LSn=&+zNg`P zCU`{g4Km-e@O?h`ImP!7tIIj1#6J&w0d+a2l=$xu|BK3a{{_oq9DWnQy-FTGV7@QF z_eIvPPiwSY9@!tVxaSe~OTlAG4u2W^OaG5XbiS|soRa$Zl&x=Ya46ar9T*ynbosL&alWR~Q}~92k7EH$?duBcWjM1j;NV|K8!j=s>8qANzMGh%EXK`*bPW zejyMPf`P7q{%Fb=2!4Jz=(D689g&g2{vE-=pwJgZ1#;Q^!Lxa)a)6so> zgMCj1g_I>SeBy)QWNUL>-;FFX($N#z_I>OUTg?im;i zP&PeBF=zoqvvdvxf;}TAf~njd40-TyU;lCX^qEq+UHjqr=>6MzJ9lpD+(Q-CcMOiC zEc;JTm!er_iuq8VkTUf5MWVP2f5bixWBpeS4y;0Vd zlwJG{4fRt8m{RVo!qD;H;DKOdXjteEit{#a>u_Ww)63l%8j1w5SEk3aZ5s^iKXNdN zUJ9pj9v&JF1-2sRefgM)#TW7qvO7ifC0ad(I_V=qR7R#z(b!LIx7r?^oT zT=-!3u1C5ssh<@3!m7WIPdU&%`-QC|(O`t;B795-h6gbnQ0bC=tik(Pdk+Nrg9A^Y zzN|M3(}ND8MxsBG=Wibf1-pWgeqrDQ);OEox}Os;`#Djhh+)0I54AXWBG`XbCpua+GBhNtuEK*dnPMbr4fV2F<7zw7|B>qq_r8 z<3v9SQ6337<`;_Lb%_gdem=l~=;cB1>imX)-ftW+pw~^kG(f?WS)2j^Eakxgf(8Sl z!9dE?&t_dWCaR^kcd#!U?CnkE^!A2_0>dG4+k1OIKin6RLd=~9wsrIXMA&w9@9Npr zv3HjrAEwT|`wwpGy2>q3?e0W7H$47eBq&54?;8jR1Cht?AL&2ZCxq`8hG^PF9zP*0 zeNu*?kB5eyj68lA@7}%>Cwjxf$JZ}^ycPZO)Z=>x4nH2jJYPy(2hfN721f>lmh}>F zz<@=T_4W}o9vEspF(MEWz+TV75y`{r9GA>58#gBlYsYQLypjo%@Oe2-Mo&uH6u)o+ z!Rb92-~+nXbs~Zmum|+#Oz7L(fC0#vK}Fl7a7Vxhe`CNIFyYq}a0SfxH6stp>wF+D zU`1*RLUZ724de%G_{|yNeQx0pitWCtqfO@U@RKP!?NGf(ug#V;m3#=^5kkB{h@d#&r0SuozH79KMWlO!g&lR}e<&%t{!gv&df~ zoKN2^P!ZdGR4rX>i&C!+AfPMmV~ zMzCMAwZS6$^eICm7&;;hBY)v3ydu;Vuh%OGR3auWP3hj=QKz{4T4j$fP+UT5PII^I zTv_!St*^F@cb(spEUjWc)l0{_X6%*8m22_2J6Z0<&%R{c67sE1);5lJ-LiYxtWm}R znW^JYkB>{}zhm+!QKVMJW65>U2@jA`T+qvAlmv&F= z{?gvX9ZJ)W)%YpYoz)l~*-w<(#hzp7t(E+Sd4V6{tuz?Q^p%3}bBd3GQ7ArRyo~r_ zX!v6Uxw9VlQl+yVc|g_FQKuYb43I)bm<8`$bEN^ydKTw8SgM^q>XwtLEl}%%c6;P- z^;al}7Rg`7Xrst_0-1eLmKBUoxqe{!WB`%0(I{V>3V=fK9N}weRDRFeJ;xvW-%`7i z+|&9;xs$w4KU#V4=x{VJbaK$!HyH4;wcuq?$V(8pwL4W3ks<)J9qAhm0Z2U^>>mc4 z_BjP2fJ87jNUmq_O6B$TGkT?0B~$W+Mf650U&)v4XV@DfDf7|3NMAH62w$d*N_&+k z*+mPq-wAyb%aI8;g)dUb5MIDi2-u_y)Q||RBWdljD5G`>+OQ_SfzZf*!|OCR=XAgH z%)~R_s!!CcisQd?Rnk>BuglGCNfwn|8ofAr!7%Hpo~oO1H6&f0gsUO$YPe!ZG;WDE zZkcZEm~m~Lb(c=AidDDIxHly|#R*Sy+|zueE77t$-m-hTW$!J|zB$=@re*s(QTWZk z&s~&oH{5hL%z8=_9$(z!yHYpfS%xw$GcXSTBLjqt1C3x==RKApF6 z$mq9AbccbaH#*uoecXG#4rkXoy*8NNfZq6QIEp#0Kqw@To`V3aqh$wzAnFFa!SLZA zI5dIuY30)i&m%6IFv2;w(zgT)QLZ#-%GM@({4vEW#0$fez9C%NaB)M-Ucq4ORZwCQ zN!Tw}jrJP?kPO^@4}kO%7gcsItp=#TCgO;ycmhAhzoz?!P6j|{`KW>?98+)vlp{Sd z7&&8$+GM|gUQLb8y9dYxpw^wXBaTB(tNxzSjp>eQ09M4#S7XU8Eii-@O1*PRe{XOp zw<0Z8shqR=E5{n{5TD3g|rMRefcb+&gKpYUD8W7o}{9E|I^{YC=k~ zo-zGf2BnQaUDIl%)Id#=R-RY&m0e>>P9(hu=uQ~|Mu2+-yt6G>tLK~L9Ms=2Wd@8H z&ODk{tKYe=#ti6>m1#Ns*6mAcy+&`#y~qQnqkpwr6l+L)>NvrOZ4y25D0luvd1FD0 z7CD9%#~-O6gTuHr%CXenfbn=2KtpY`P4*kp2TVXUuzKk^WgIh}@#wfQqde!30{I9z z(UoEhbpt=kpXJm#{h!z0CsBL3{yy{QGVEF2KCePedj|$11A(A7dNimBW=AX2BcJSx zc!N)aevbwNE#4=GqTcS&wbCvq3=cN?yx6$GjPxE3!bSW>?-5}ri~PbQ6`sIA2-SF{avtgn4T}sQalg*%UBsBAtvEUmmSR0mX~!t7 z9_5N#1cBLJ<4;HnA?^hbh7saVaYblANZ4yLRmA?n$|2L;~bj?@?ep zArN7-T0o@?4fY~70)$gkgA4RJOfQ1}DKj!7)FhP$7Te(=aD#Tq6r9f_AsRF;!q+Lb zffyPwa#qpyx8s#eFVR$q%wyW7XRZkxEg(uAuq z?rNNNHN7>EXzh%*c22i$i@UZl%%m>vsr%MLZyvgQXxg*#dru|SJ`l%$&jTM-H(v3) zU3InUovxYcT^AhlI#XT~Qe4`1ao@M<-&}fm>9xvRp8MtAL71PCQuWybQ@A@b`-|rPB+V;fT z_T2L9oi}nNyZL!NSFr5U+YMZC%_p28uL=E7-}II4c`Mxie7lhIR3_Xlad*onoH4f$ z^kl-_7q)Fthg=d zDwww+=|9iAe&1T&i4dH8Z$sVoD(-z>>GtK^kE?9km+F7q!qaMB#29+fizGaY()GB0d}Uwg4(4$ zr}st`bVm!Rk->R7!v#5MY^#y>w49VpSS<>vTBTy=3*-Biz;k6nIj#?>}k-jFC?6)#^kUA~66 zX|tu?L}^RBv}L^OOB%c?Wz{CpK3cU;^I9t{z>i|R^y^fv0_F}Vdeu{uX$vG%f4m&bll7O{edg@B6LaZJk-M zHR&ozxV&+fcg9sSCsO+f*Rr^4*>~+Tu1%QEv-!2t`AcHc6ewgGeFlXppkz6>BqlQH%(2 z*UxeDIY3I1ojX3Z+O58M6X&U#H&@1BHkPa&8SEEA zbg_u}g{@dSpUI_A7U3yyCL*-)@?G2^Y?zEcaL>hl-eaI`n##+1(l{d;8$6i4VEYd6 zU(R5nqSPHyskW@_@JTC+9)Uma0pCJF0z_YW%P~&#=V>cdwl+0JK!5L)W4eIhb%nC# zx%0aW053jccPdYu>}f*dp3%19K@s~0S4x&PdIQ4(5jpbw11=7dNM=Do9%Bweqz{o? z%BrLhzJnTK1rd-F2zUzD=|!|d%Jd`zvykapMbHCsO86=H7c%IhWFb=rKE3b?1zV#- z5(AZGo+0%SUZULTrN{J$5SR2cH|r_6wEyD%sjg{{Z`}H!vp8wb|2t2`co)e`_Dt;g z(muk6D=}ZKxd}^E+*0)|33Tk=w)ZnAQQ~IClgS>74x(CeuV3-+V%opLm)d(Iey@6Z(`+#bLEraS#UTj__#= zAw71(drVaxDr#f8=b;4s43^_7`b+wMXEdVjNOh0t%X1_8wcPmv@cus|o=nt#M-MK% zX|(lV|Ir``pBX7H&pGeV5%w(+t(dAJJv>H<4qf{_uO)A{dCq{{t3s+$>i|O@uto1=n}5ZxU2J@=k*kR zCsKe?o?q9_{m|OctiNF_@2J<`s5iph(@mRxv`+vNBW1u3)S-l*A@*pY4DG}&h_s5D zSZVvNIaQ)aeAKp!{2?Ju-JC1w*@#&P--Mq4ejEpdGZcvej|~kBqCf&~0-?ODXw-+X zYZ%t{gu)K_DuvUlg!+xP=THBUy6%@IqqU0%_n@hD+%RLQPuiRbTXo!49kclW@RE52 ziM-l)UhQ<=l5x{4SQvTL@x1CQ<<}p&zH26L`?x7-alB-ou%8EGLT@ci<`=)TcYN=h zJzoNmMlQGH*UIO=M3$rE=R4e6t^AE5W5+7)MmgWH!f>O)Kvk@ejSf`5R==$ogX!D(LA}8 zQH2MgB}!2RBXW<)kP#C2VmS}3@lnesrnd0dnDH19%304T)0jzU7&B?{1J0Cb`?EB; z+F@t-^GJ23?l)~8a?ub?$Zb4`o;%3;tzUmie@b_fsmL5h8%AxzPcb1fy})Al2!1I& zK#)K@PKGXF4G<(D-KL0OBi}z_kpQ6uT7fCEv>;LjMh?*YgLW2iS4EAR2$VoYX){zc zNs+P_YM-P7D}Ltm9vzB^OANZTR%N|0)GDRxKP<9qfuc#3U@!~nDE|WmMQE)N#fL}S z3LHnE!l|xWVF3}=5}d+;C&I*BrI#ER9h1>%SKaAdNwX_vE}wdokfj+QOU~k$rI@i- zU$KoF0KZ<^^5T}MRd24py#5b2CYP;z`?)`QZl-w4)#onTrgT#~zMg;Ox$#}`;w^tu zSam@+=P8^iT^{!=pDn7K6sFp*d8UijTwgj}wBsXB<)!Y6-BYV(JdMe+s+aeCoXZt? z=gnMR`R!uP?t0mL$$ruPdg!&mY1`7%U9|=G zp9&@FH^u8WO}jV8?3?Fo&eMB-z2M_Y?&BH9`$nC8o6(Yiw-8PN+=^cqha;WT8H3h^ zx|Xqq(7ED+5FBumSNSPjK$GLaa6KJhi@skcLl(dkJ>Y?9OfN!~en1(SgCWgc_+aiD zx>XW0#kWFGO*2yXfAE4Lqu~gI94V8iD44RyN`fi==`8gi(k5n8o0OrMilIQPfrn_a z?1Tf8CD(JIXR`f@XF9j_^!8b2;f3hr=dScjJ6D|EnY1}xS~sz7s_;s2+`D4hvkvdc zwmRLKJ?kR0BHl7@v3$?4#WLFVaJCAtvY{+u2Y^E`IC3au zWxC+RqthN7V(opF8USq#r**rzvrt8fVo1eD1#YUeFsdMuM|4k#l0<3%dw@3P@oB6i zV$!|_1pFJyKn3`-056j2ieYps7zw0c@Wc~6!f^13C%gk9x=hf)3r!Npv4VqMhJ!$q zMd~f&Ndhh`4yYLN-CplXi3!LMZE=GoiWSKPiJicESQOGNWOS$iqc9=5-3I>F*MfnjNL`nc< zfGhhE+SA5aGe$s1yl-{nm0H6}>eEu&mz?x^)s5d@{gT$HF0^Avaf z1St!5_b~b8ol?vM@tB48@Cb=Q@!@6Lh<7`fi7Awk${C120lpdPoATbEVjhq~a z9!=SLW&O_HUM4gI{-+0>pRU_dFc9fw3cV7IA7Upz1T%&n2PL`4!zhIfzs)&kcfPdq zg`L<`CRe_(?$vcu9j|VDOF!dkNxIyZEEg@4c^7R77ts;1hRzvR7Ziv-vK3tDzch4l z=v&Xu*w!TT3ob3YxNN*LY4^-IJtA$c_7odv`s5dSP_(K89Mo%d7qNY0yrOkLUsg&>A*EE4Ywp37Z#b4;KYUYuFOB28u~ErsMn2(RHMk47=NP>{!I4rq&$z68!xN!&vtBW%=@IdMci^e@xQIf-CMK1!;` z4d)%nq6+-jlWnVsVlSOtw&L5v%$2OHrQfn-bv^x70s&m+h0p%TCdmel9z z|EM=@X?VkZBi^CG&2^@kHNL_>;lccOfS zpVRBV(~EEywvdG~M8P>coF4lH`4N#S!V?(a0IeLrc||&=W`T;5c;wF711NBi9Zj*w zAVVNde5wGTDFjd=WFR8a>Q7k}vN@F_UHtzb>cae`lj*SGxpjvq5o1)r{D*= zYT~Y%gll=+wLIZk6?Z|iNM^H&A;e5gxZ2{bwrjpyuJ$<;oI8zPyzsOY#gxlISTT(N%3WQuq>-g?u{qpmBCrhU7wLrG5 zZFeHHdT&%%yKLP1w#u#+{rk;4-u=pEhhPOz<->J}dluV_7SbL0Oi(2+5~NoE5Av5D zoEAyXLE-x|O&^W;B1xz6^|jJ;7qPK z5h2R9t9U}eP}^S%SjjyD@Ijk4ady~)92D>>`*GYc;-qIi_ipLkK;W4kq|*Y83c{fl zqg|@pmv<{cv;K+>k(&GOR{t@Bx`iQ!3N=63rS>esHTZ3>j&*3*W;Ci>wA;aoT3D z?(V-p1mW-L#Wr>lfQjk^Y}<##0VF6`z114 zTXm{Kqyk41cSrofX;RfvZve?;*Q0Dl(`Q@ZJN*4PVU zKqq2V_f6+_#OxijwxSm|PkG*~x?B~vEl0?_j?b%D(CZ1+(C0dUFt|J~JvZ@O%-IyP zG~qp4TAwIwikCKBS@rgot6Qc^H;y}#w$hlbW@;!=zcpUJ^(S@l`fe$!hV-mfSc{Wo zbYgZd!#8SgI%}ESmec_gF4B;gaV#*&jo=pM<|XXQ zu0Olt~LCuYQv;{wrt5%|67}9$~Mew z=}DGX-PY^w<4b`ot=TZyb*p^E-0Jo5@)h&BoOdJiql+P1SQ;-{db4P6Y|Y--ioG${ z-uYs#suq2?|3g>Nd=Wdtw*01hIiwefvZe8|rLnU0G0%Fu6`w@e_ITO$SlNM?=K$WU z+VycyeZsTlre{kMg%q!j7q9+UuPZ3L<=KMDtX^}WYsS+yS5!V%StFJ8DHLIpg6~9V zlYCd-wSHGS_v1|+R{Z?L)lq|=pSI`hHf8cfF%2bJ5)PsziRXRB2eBr;vmfG9A_TKG z`$32fA?e7U6ouu-pZCEw4AdO90}&@Qow07%k_RK1(dA4qMLEkdslwhMfEr^9gkTJX zK}fI+Mr%6LxjUM1a*$7C6Y|1wy5?o$_N1dU=BQ6P%M#9}o6aVn!E@xMnFJDjPL&4D zJ0T5>wIlWrtQQ^#MYWOZKDHg%URm zUB_UgjrwmHz0M(Z8WUD%hUaKoM*m1sL#g{1Q+5$}ET-;SkGuejOl-x`x}FNe>`fp8 zayQW8+H-Nw1?MMvd_k2{Ucl?)uJ!X~gEePySJ6yhT}6QLZe5k8;7#$fp5trL#K2;1 z7tJUwU-|c><>w|qa_Dwe&xL~;Ds++fQc2T=iIev;#IHEY%Ku@AzXu$E%SVO(V zNA6fiDK*yuu+KjO_G!Q|I~}MgjY$9)py!L=(!`;mGht7&31E;hRHSJ` zzBzJz)ZbIaG#v|LR2fFi^A*x62J^*ujCjadkK9Vs^(acyps@mJM^RO#P{8n-K|OQ} zh+x3v)1VO0I{y6E5T-#}L9z6kV}LhWVF8nbt=i=ZpTEvq7LkO=idZ9|*MR{6I}R9Iq}_y5fP{1tyO{}D z2Z4{mLjs*qvWY*I`#oSgnld?F7yJOW@i{7qlFOnWDru@flvtY*QcNn$#OEJr8hz)?|ePQpAK*#Skh$wnG<-pK)F%(9EPJqT{5Lp;Nc0+?K$3d7c^Y)MQhk|P3xAzDwkmfyc3CM1i{t?MPdM;upVSUKYk61^wt(p;xlIv5^e7(Am6JSYe1 zXRKMsk&biHX3L3ilxe)MBM?F$*IXYYDM6Tr+&%`CTV$F1)`f_P~R;Iv+}wR3u7#@eb-H_HC1LfW2VHSIq<@Q&#R{-5yIyJOxxGoHP3#pP3`gtsm3ZM%unedRTY z@{Mu&zhjP$AFjQLQ-^Kw;`W~vubr>p3cT}m91!Y)hM9tf@oh*@GRU59anXcM;v+BS*p^J84)rF0~r|tO{dL}l1=q#J9Uo&05PNX#$GTR#W zv|clTKiZH_q(dz%$GFO4mNKLiiHTaEV)$N+L10r6HSSdRSR&u(U>G z?4rf!1?oBk{{eATF>@V}Xc`C-7cSPFh{K5xCk+~O`-~z&$Pj9p?czG11#(rws_%n4 z1951A$7plLB)&JD{SZxOKbnc@oTG4`$BjvcJLafLIz0&|BNp9cup{nnh`E;~JtYax zvbbm2HRFtD%^VJuVtyCAbn1muIAA(QfempFW*A5$r)Szxb&s)s7X{yK>>~%YkqX8> z)tC?WQstD`r|2B(S5j&O#%jf6~~@C>(IM3#`qH4|BtrN=ZiBZQrRP!o@3#4Mtn zC6$xIuaQ{V!8FamTB?fKnwcEP8@GEC_J+8jl?@Bs* zvu|SGm-b`QRIeIu|Gj4nYuP!}EqwuOpcz9NY*1Aa)i}fjAno^Os6B+TvuT5M5Kq(N zP^JOG$^Bc*USb4h&)$?vELzo87%g91F*WoHS#?_ycP@!p#3PQ1Y7DCN+t!VsdUo9y z7bO!=h{_nSxy~)9>uPLbOxa=)qCDhg-9s?tZi{=2XM}iJmJ$rlW;djc&S z+J1zccxB978$7g{0kiL1q!syNoM{?Pv`?Bp)Fy)i^>bpHO`P zk?(jiPLj$&FS4Kv3%GI+D}su{dRE-RyJD@{sa8}&HAs#|b-ij3c2NvgZ&^(PKb~It~h7 zLC7WqfmW-qmtNG(+2>MOL+CY*zzA-%z`4}9n)){zFE?HXV^eReg#pKT_Pc5w`<=6T z7L4#GMs4fc#aD~pS#q0m8rv3XDvX}_&AWMH@mzk(ypbG0E%NK<&CF@x@|Mh7nKOsW zaV*%F^AR0qa(tq*84DKlaLtozzLfbHjX9DZxf~|rL4Lv2Vk}>HoX;~hF4S9$ZSx)$ zlQ&jMG2ud)CdU_h&-8wxGb1u`Etn@4xQ0{`Z>&|~*0Q+dSFiZhD}F33YQ!Tg^0a^P z(3wM@KoNE=#dUv7E;g6hWavj1Dvz{^`32JQP&FJCd$C67Fv5N*)Id!_ExLSkDu)Q) zZLnl>0>{Qc9fGDEetIA@0CUQs(1_Hh1aPIGN(EdMge%}4$)P|1LNSA=$svZr_K<{0 zRu*Ns4n)bICn7?dE5c6t2}py#!6EOHurG`QLP09;F!Z`0mWp@>$TW8t;wn~JE6W7O z)vOY;66D_hK(k2i^d$7Yh2Rk=pr%6_1#Wp+>$4ye*}y=P#YZ}ckM)E5Lqq|TtO=%g zL@00c4m%6MR>WvNwUX(VDCS4MNx+CCeWV9g!#2?J#&N?fONj_?08S{!J2|klBQJAm z#+`ITP71)N5c4-pBOm&WfuVkw=!MlQ0 zk9B&Zg^=@&r+3{p=!`xwJ{$L@yKBx<6I;AWLk}_Cn~Yf|^*O&#iE`3rnE@wU4X~bT zg!w8xG+_;3?weEjy&a+fUpdR+$nQC7INWC@4gpN4<3NovJLCcU8FdKtxyAsNEv}3* zlDNfyi@1;&BPpr!l|pgvOHOehGf+=Og{2kc++A;6Q=K)9o>ZBQs^+*B?^r#$ByXcK zlM4(|O_h$QqA@qdG}BdGId*u}fM&8si-Lh>nD4HF2o1_ct`nH8HaTBaw=lq+)j@ac zDMh@k>mF?t88qGoMgs=}4c_R;kUo;e=`A&J@K`dAkOI z=?(eLQmXMddpJx>1`+HDoQvT*nzWxS{!f$047rln%I3(@Cxn6{!jlR~U85 zXE$ZYq~Z<6EKnqZonzFOS+EDUDM28E7cLDE$+mOcf=*|w`=upE-l-@Uz?KlopA!N) z>Xh#SkV=MzZVZsl^96yRHs~SzDh>2lCD4-tQ!NG!!`(J<|uH{3Nr$RAavc^!Q^B}7VS2ST*S_)m|=)8 zoorFVGLLM*$rob;2(m7sC{7~}ara|QRAA;$XvkX-hyz}}Ro{jJ^o*rM)^A?Ef&-#Jk zv`qE%9P&;hF0qsJ_DTAjqaNC;Xz{-WVcf$WwzWp(W^4 z^}e7GoGbUa+^?r#OcZ$$VV(5|pIf{!ttNw&+Oao73Z}?k)U4!kFm^ezFDp^m!en3S zya2~6RG4H76>R1!>F!c8e|~cSDbsB@43!6L_(V4p&n5!lXm zpE6->7*!vB7fulNz-dobQ8x&lG!NdsQ${m zC|Kos%KbS4ld6krEQiWS4YO-vfFjFiRhp?Cy1ocx4XNTO0L51z0wP8)s~TqniBcxq zj)7w;Ok~ACvk1UvQBQ%mn<61?rl{f_MRY@tc+*O$#0e7_J#>WTXt4kI30R_timbu_ zW%3Ta&f^8e0y6ra+uKW*FR`0=dV95%-9$4zIV1%WkM3wIwGoBVCtVTXR$7aVLh_s; z==oDrok7oe`&#RYq_Z#vRU1+qsgAp$t|pRaH9+I4h*V4xo;q0Il&p&HnDMOo zNK#jr*R?QfmX|huW#eo~-Rl)snv#_@Zyf*naU7^gtlkk{y<>XyuF0+$C}$a*6)TeU zO^N#Uczt`q+aB|_&wH5y7lrzuCH2Pf*N*>6&y_YzR@`2}mH85-o$=Dn>C$Zp&$gIn z+gw#04CC3E@yyzr?%LZqT-nlO@%rnl5*zo#H|_zFR#rGyRs|%j!22;wWmP0gt1plx zqQVMjg^}6vy12V8;a(bdFTHZ~y7`^LY4^@KSJ7nQlqX)@Hh+-ksyF?5wzlmPF1KO@ z$o|#qr*dYzZLm2cO6n3`oQhsI?3bymVzFo?Bs)1xm_CM9SycM{%^4kN~-PijQoA<{z@1Jqs z|2Jrcoy#kht7hf$VEWUFv}6EO@&A_yX?ULHchvLeI`Vc@a5oAIx94*=T57f%^zS;I zU9GxzE1~;udbi3z?pinbuk|9%dqwz_wQ-QSaHyDx6`z<_TzTaxy&Kuuf z+re#XH~!UHBa;19yAfVL=Jjy@*kIhAYyPp-g2X@0x9%v_|F~@VjspD$HUl#Hz)2Z> z;Ni)qz=+TfO7-MlVcJov|DaZn(C&T(Z$b-bj|AM~7ru`77r8GQzUY9yiff!3cZ?g3 z=$X|fBdjqYTK1E1LP61;KFbdP(oGnI`&4MTSY7GcSPJxYEPi3|9RMI#2<($?2V#i~$ksq8`u%b4XgUBLPc1&ZSYhyJuJZLd*C z>cJeNl{1!etXeKv{guO?=1gg5f!?2K)XqCn4l`+*DYOUzOjij!NhcJE z!I|~Qi-OJyo_Tq~bS7`Yq-6kDjt3nH4zXN_rEy$GiS@V&7Shik%9A%zhE@=FJL@@C zmF0oYbg~Aiv_{*zI8|inUE(UsUQHv{nlwbwt|e-S>`Jc#iFMHfE%)vLv`{lA6`fUi zYw9S8B4eP-cDZCNf((WtiW@<&+R>g|jFOkl#-!9zhuCObGe?HGO`cUWBU)Pt%L3TQf}l76nY< z1&+6oF|mXOia~nLDLyDFvlF{9m7i8QiHof$m7P9)n(^~t6_eOtWXgB6HVv7Moaj3_ zsM_6AB9#ILM*bW{eF{EI$&#sHyrczZGs&KQQ{3GYbFYcn*WeB1t;yYq@|E%Om5K5V zar}4VBAE>__lBgsP~=}G>`ifdQ^MXBx3^teGGkvy+)bF(luvcc*z0Cp<&zJ_Tu{-1 zjtLWFJKL_;{io)?Xoju1yb^}AH^n_o3D4@dXZ5wfjAtWE$>tU(3(Lq@$8=%C1wAa= zx!mK=;V6fvKIU$Vt=XAab0EIvz|5MSq^ESwy(H#d8f)uJwC#+y?VM@bt)9YQrys~f zexi6;ym;9){Y>#HVBU$cmUvl9qO9{~StpC)ix>M6#mnQx%WoC0n4_~3tKyzj*ACwD zKslW&hjBd%mtPmlTNYclJF#wmeBJ(;bq^%v6ST7)Z>;*kY0pEy)YHuZdT#vz9&tat zy_zeoN)#=R7cGaG!n~3XJ;g9bm{;=8pa?u*6~R+FIXrmu)w2?=Ev~ui$=caBl}{Tf)=3!n$LX z{>Swl+>T}X4;pmzUS@>X=tg!N(gfv3VLVd2Hp4r*95!Jg;S&`@y*L*p8#Zq7!txK3{7GR<^TgXYTIN$K zp~m(~_BwElAMtb{&?4(GxRw$!9Eh|CH2ZWSrD>pRC~;RTlV8FK#>BBhD2 zOVbXOt*3C>4H+L=T;WWQs+#=1La*a^fk_LhR}>e7$ny@p01>6*=Oo)mv5SOR&q&uZ ziWaek5DWUHxR)3$faDT)dJ3d1D2m<~U|}%DOY!m`8fB}OX{M05H(VaZ&a?b4N|K@% zYv1!!_Bl#oI)0K2Rf_V+x2Pf}TmXDzKs3>rGE0?#a;n&CsiJ=9&JKk|hB>MP^E|_J zog~v*jSzq82?#IgPkinZAq%cC>QPyo%*RbIgwCJcInDjb(P+(|@8RhrnRxsx z<1{<19M8DvLtDjcap~*ruWg<#ZW`Y;Tek+w=UZE+qKSre@rHGYhR%3H=X4!OFqSyR zw_n%<Y3ixq- z?@a5iNy8h?SDmq<#w&chpy?;V`1aZSGTi++xqWioR9B*Ib-ZqMtai;j$FE%ilf6?r zV=X&qW$xnB&$DsO%dWH_-zm?Gv;K#j?-+itiwY}Lt`!+KKsz>3yfj|Cbh>z1EO*)X z!+6btP&ZGN!d#ha#mt)SxT|}%ymo5Gl|$FNrpr5Gc^wyu@S3Y%dZq93u|)mmcs;Db z)qd!PBHgvXJDwT$_KB{K+&B}*ZZ=`Jj#M@z3#+aK60KX}ty^%WtTIQE3;`~X;bM`s z?2TKz2}@nv0^|ELmZo%D0bs3HFeY?m+)_C?GGp;E&a)`weF5XB2rS`dXYMgw`GqEY zFr6Oq&3ZuZ!4{=VaS&1?N{e{mWyHohRHrbTy)=)r48e&8qL`+2Iv1V69OgSj(~LN~ z5T4=0Z!XzBxX?9OHwDRnqz)w`YE(m7)L*1}AHbK$F(*!#_-LVY-oPeW^t|U+1%1Wy~r)ij(HX~iZl7DXC+f|GU~^8mNkuh>NeP|g~BK9Bb;0{<-yG~4^2B)jT`3e7HfX8r0P<8%wBb&{nxY3icdI` zHD5Y#iVG<6%BQ-1mgjqG-S@h0HFqWpOX(6p@bg-__(XGOyt(sEB9AQH=jQ*)%;h&R z*PZ!X(_CA%ERN&_;uX%C0pzCH!56Pi;Opxnzri9 zH&*f;YjSR^GLn0}75?w)j9YECcg<#UJFJNRZjo`T*ZOX`h1_*|WF;zbNm^Z>r|uT- zArNR@izkc00u+xI3jn;*PWMA}lDGzQ1ll_8v~&W+B_oTEJtkf^{g`ZG_YhrzKwMfD zO2!Tkv5n?VQIxKyUL0NAfgDs8Z9{hoGDXH2B4OHlQDe4yy-F!)>5saytB{tZDoGZT zjaDc%Z*6VWuByN)!$1pju{@Si(N;}q^ix!mXX!=oNqB``G~u!()YRVsy*>bFiTn&P zNJ4EicJd1jJ#@!%HW^ni)iL~HYLMm_xkSY=azSsbV8KSNojP!4=WTx8=$UhDm^YFG zNt{T+oEFYmFmGkf91e_J788Ijr*I*c`QE3;8R3tuCSyHIk6$Er!GI~b#MI;xHPy(K z&mG_&;y>2s8}pMmu*`lp+$a9->}J1nR{L!u!bR9m4edu8l?SVh9)7`(_ZQQ}=D0^Z zL)dL%cItKK>>46;vnWCjSlHdzrhpZ^FA|%Z$8mDiZvltKma;!QBpeS4Jo0-g$~4f9bz|Y}+V4Hd`T^)MuAvVIv>OX6 zkYc+p7w3qEp-L&7#;5Q<@k*J+$S_$pfcx2cr7!Wip;stY9mO(!emFQB6h@F0YygV~ zl$ePl7-^(ru(H%2ghlx1(1{ZufpM;Y0ct8in4whuGisaPlugcVxP9-Y>*R(i_D1zcJWsuQIg>drmX*zF6ikp zWlLW!n_0pi&`kLjz5bA1G-pIk$6q6R#tcd2W+Y@h4>qkx$rGd;V}uYpMV^5KZs`Ud zx|Tp>hnUIqA{h#mr=V9PO&mCXcLHahq&o~o%Q9zUM&O$?C!a^w%y47&bOH`R$BM{` zRYlxhk+9dr?Sw(wo95^WL0s`sHRHquMfu~;&AKZl`@gkm#@#ks*%WKuGhMm&!j5EP z^99Hnmyi&zbIw&L-G6oPmdnS!NL)EpkFR+*=aLLXqN|jL2tzh)mt)w|wSJ=M6Eht& zN=apw8exP?7eE1DO5WVPFi>K8pUxqBGnsfJ9bkVP-A(r8VP)P3Il57c@vBVbFqm#; z{8`3KDoatdBV~mxOk7Z-OmDSzWBMogF~c|c@0h+!vMmKXJ^_n3TFmu(0ozF9UD9YR z3{LB;^O$kWJZ6z`eV%*P{Hz6eYW3d_=;}MSRa8tV5@YtCH;k-=wwp_vFXc;(EAJ9(f~> zrT=t9RlE@D9SXO?dIKDIN|)~v^=dyO@_a{->SUk`F_cFOK#C=E;(~e7GZ~$F=*r{J$4wM9#ETkc zihOi2`1a(Q4HtGL*LA&&tHf8&>x>1PlhrL#MQ@f}F1ykbt6qPt>t^-(NfWpY6~0*c zCh!N}SpVw!L|JRRtaYYrIT(a*SYNd!ir2)8*CflmiSlLf@@3ZwuNS^k0$RMJ6qr~^ z)sz)REr^g1m;VfG!+44(8_4$Em8Y(a&9CO%MV~^lUhV@cu%Izn*YFK1T~1Qa_|Mql zDtz(sO?Q4(D>mv5GlTwGRhM0VL*GE}W_PDgcVlx$Gd|w)Svxly-&>*UTyK1Dm9dN0 zy|>;-KAZJ$zt3B`tj71Pdc=I+ZtN;BE2KR-pHue88GMkb1?+$1&mK&61?0$n5IYj& z&3e*hK6hCn8oIyfQY{9sls!z%UTe=xPscQp74?243?eAhb2$xID zmYj*4gry>GshAARSZc`!cd8^T<#7ux6kx_0_13&a`^+tS)2FjeSSRPLc^}$cm=e}J zQD65zm35SHH_EIX4Y;a?#~TDSL(%>UC9|fC=Hd9vW9ij9#2Pk=yL^EHW`=+yV~h1T zHJU9}qL$b$D=>0Wp~4vbDMA*5@F$2q>XykpBF;02y&K455yh3t-PiF*@2;-B+j@I; z?b{}trh*texlFF_AxlyxV%R0)lJcBihPcG#dSTDCJI1c9LQBkMMUk2Gj2Yfa zGiaho<1#hSG2;N27QAUS2kD0qF0kn~`y?xoW?y>#=rG}VQ2B!+y3 z$v~J?iE&n>yK5k_9PAf6Ih_~C5Qmp&BpCaKpi=hL->D)|^dPDDs|AkMXAcMyNGyu? zKWThAkTY<87iTR>SeoOO=2^S@LYJ&1$jl1_X6zf2xCy*>qIWVd)pe!*T7AsEp5&Oj zCwBi*F-(O?!ocGXsMhZyTO2d_U-%hqS2$IRnP%yXEBPumR7M z_98MsEDY8gYkz6d8DTrmZp@i;?4CE`S7Ka|3%stXc`Lbch=XM#7nA_2=X1&Bz`4m^ zIpGokDrLVNw>{{BpYKNj$|KJ-Nyrf7{J7Z0uX_+UNl+iqwId?H88MP@I80(B8Apsh zYs!5v3QkG*0JtSV;bDRFV1-eSyhEi2;^-GT6LB+eAS(HJ0((c{_-zjmsOAC`F@R1~ z_9opHQq0CRVT5I|=PVD!WCuG~a26goSnyMHN6NrBJ)1-yhIm-ReNXou9>JMPT*}*r z)kKv9>MRnwW|$NT!XWi%S$gZFrngFgW|YdVW)qJb6qH*T zmc=`^2%Z`uw8)oDiOjFxKkrWod+ z&TK_G`TT~6%hkj!H8Ztqrfb*DSk})v$`g);xT9g(;Y(P2H!Z$9Oq6l>&?yLOIG27_O^?%0T3n6+DFi9ENfQ#T{(P>U6w4v$nEMvLQQO^I1(#7d@f?D}` zdI|LU3Hi}WPnFJx*B7|C-0EpV^=*UESb5u_Gd79QDN;Yem4{{-9)6(_Z}o^&)*_^H zzy>Tu13M3F^jYL3_^?1$m+rCz#XvSV+RN_+l=<6ED0TVW_0XY$2~f+#N1lA2J(;8h zYCK6TOBn;;e+^!h4B=cu?`4q(P{1E87H3gLU$jOLQlveHN^znO@@k7W>BxU6G!aTT zym5zj+EJ6R)ZDbxNONd?ho1id-@zMxXo4$aMbe@G8i>koogi31U%`FIYWX={#6TzSD|c9po`%BZtw7G^Fu>MUG)p|#WqeL1_Lo&O%c z!SJW1cC0glKtm+lqE{v{v*@t2@H2|^xAf9lQb`J+mz%1UzN8j#IJ)+>MOji5Nqb3M zNB!=yr1aR~3~YzP6+r=$;xaRr8z%*6!FkxVKE{BXUF&1QFJ0?n#??V|tq)xdqA!q6=q!FV}nmo#uYwxc41HY6+XGlC;bW^$4I`fBxSx|80yER&ZDLB&Kem$4ATze z*D8gjEWMJC=FrN=HK9fl#eFJroQ#cIjzc?j0BU(`%f`MgWK4P5D%g}K9;rCxqv&|? zNf!g*L>XuUEjETwqwTN7-dHsG)jN(g`GG8NWjmAWrOi6IXWkk}Jt1%;5QF)d{Qd z6;>xvR6c7ZOk%oh2cu#iMo0KNe2DA*BXa$}^dhweAx5F^;FU5Qhml2L zD?HOdz6iz~()4c?L01F82;!$P&^4P|4E2=UC07cVcEStKkb=SSi^mg%jq$?9>B6Rj zt10GcqCjX%QDEp|C{gH(7y70Pn_(wA=4!rY;2dmhZ#%yir^#_Z2gwI64t({vcq-~w z1)QTkmb+xm)%59{tC{@~wqEn=S+`d_(Nk4>!HBa-;8j{LT3@zhWdP%9?C{Q=UloZt z{Y&ID8g@3ftB`-GsVhhS=X|HZ^cPFvy3xRQnoKtu$^C8t-)S+uTWBM9jl0vXdv`V8 znPYl)je*=7tw{c!fk)_jCib?lcMgxx_v|aX%*OY&@Lf8~`_sx35d_Tw79X2>5W;uV&77AW$+8)BA*dsMU(Rli#w%KgQQ8$?!D(e=lK#pKFWVW0a@i!?K7&_;_{N`LS2 z*|wBjzDdN8MwRVH{C)s65W3Mxzjvu@AJi%p=vYRn_)NV$^f>2^;H&M7y0HpzCC4D+N?11(d$gqQaDVGous#lAO^LLWgcQm#%H{(4SU>|BNf{rGD2g$NJyu?QfOU8AMh$+2mnT@dDQ6NEN^1}XFdOBdEZmR zU`z*V?%#nq6=tp?g$seZ{WmF;%^rv{iN2Cl9MUu7Zc`J^mF_31}<YwW<&w=( z8?)5b8+u{oj&%#}Egc5cdJ-23iM@elKw=0BIb_^GFkmV932+c`z-%9H*nE25tT`uP zE{dCrCL3;=t8og-nuh}diE`WwvwpgKW1@UtynNqu`Tp^J3pgfJ2BY7${DiF{ZmWpd zme6&@7UxTj2}i<0y8Pff#x3AJE{j{1%~;x!2*cfgBF>huG{r4V3Cr@hW%-O{#b<>< zSbg4+vK1%oB?)_L+zyigZ$ESOnOpXaAG=YHPj7=+T&p3bzEsm?;@&q|yYlt#=ka)F zATI<(80GFj2aDJ`U<=&h6IIX_Eqxz()&g7SnI#v64j&=Lx)HNjp}MsWxMF7SAi5Gz z2-rD00;An3rdfX zO-F}Qm7lR%Oq76D%W>q)2&wsei?Mdr;eNU6($0%JUmSvV#Z61auV-mJRL5=A(CatW z{tZ+~cfdMG!dV@s|GuQF=#u@S{c8?rkQP@hSnxuG{E|zp7h9+EYZCUFoA#Pdpjllt zZ$tWjiFBg8v;0;gf3Ccdo8s#Ymko{FACkv^;2XIsbz61%8@WyNUdwlEu-sT@CifN{ zBD~A+U} z#&avDtkbk7ZH-&DzSDNgvP~pfr2aw?X&0wo!v{z;Uht~>g*+PR^Mw@uwQ$+bQtZAL z?#j54S~G;yMzS8cPAdDwBoMDbREE4t5R;7~8$udPX?U3G)m;Y$CpV+_8W;-yIt>ho zkxz3U+8nbL%cm<=;6AtRWJA+<*Gt_K-8g_vH}^7>pe$}FlaB$aqobJEOCJJSCV*i4 z!f80}MlEY`qSS?`GEd}9oOP+PT_a=Zx%V*0j2EN0G@hp3WC9+gOR?e5WEcJmf--tD zmjvn14`-tDz-W2aB>(@}dlUG!uJcY57r@0vfB;Ew1s8B9#YLh-Nu;R7TtrFM=2)^F z+i@6%pf*#KazV=$OxcX=HdL%cQk+I~?TP8e9aD{4Yq~1k5>j%SzP?TYfeL7povLsA zd(&lR9vv#RqPVZ~|IS@;aY@N>o6h`xy|yk7&OP_svwr8>zm%uHLL*s+YTzbZ9x%eM zUVCbC|Etf=IvR)@rVQf^Il_Pfv+yPjARDw^Bz|_)O3i9gyb)%iZp|8c5g*VnB$IA{ zTeY8(j(`mEo3#($qHY%Bb#g#V5$H2h`bEpbo0HB*P`b8`bxqxlM%zyA0Jf;IrsP?) zXkZ%yYx=Hujx*B$f@wfc(&jAX>D$y9g1-PuDge6SC|ITgZL9-;7x=5cj25)q8D(!{ z@2c=v-}+3lTsR7|9I5#wx+RzT_#L!=QDFln9O;`95=}qGFrrx7k&k!<{Hroflp~#M z0nUIll24E}v?p}(P;3{*r1?X1UsOGC8!}M-l%BJNmrJ!$fIp##ZpCyfrCT}Oj#D{R z8Noq$bURD4vmFnA!8GS9j$4c8d?j&f$y`=x+*&$UQ8Tt9>MbJ{N?u@W$M{Ix8d!w3 zLNBcBY<$_G&jN4hF4)^Gx;Vb!7T73ah!`l{7GLA;LAZo(~`GZq*BDLL>o$mV>JeMJg^T6n4O4APyPg8XUUFu7Y&ng zy6+KZj)pu1Z6Yj^ffSlCE!w0Nd1{YB75*;Aw80yg9Pzs6H$D;S1Z_ggp1%v>lh6dS zLDy+$a2P6U_ki-`V4$>6U7*z%3F?PlkFtD+R$m9c$558Z@N7}T$HQ6-&qaJ%oR1+S zKF+zQf)RioW$aOjblnr^f%cek=!rlmUq3jsOP3!ULL0tIgHwf1i$WgdSX%}=pp__J z)PA-q$C1#kO4WZ6^E6JQrMrxT)6G!VT(3>dD+lxqC4a>UoZno1N#xH&k=Q(>i16(^@^Ko2br} zbX)SEuA!%N`z;z+A|mLZUK6*jS>m8xv|4d6yUn;c*y$|EH_A1qGu1bMs+3ED8=_f* zdOAa&mxX^Aw8AtTUf5;$Nc@fv`Clgw>u#oSXlEYRiO=B)*@(|^(q5mLbkm_aI3nU# z1JYO6S1FBu+~P12`d!4V!WE=lJ^NIm9D7cwP4irVPujDSoHeT~1rYPrJ$Ky1QX$S7 zDaqe)Nthrw;jIunJN@7*qC+^V0fgHU9awvmwEUC4mpSJA$~4vW&1SV!R+fVBe`0*e~J1P4whPr+$Khz z8`X~i)nCi$aVeTL3a@^Nw!k5${!-flkLv{M*=1zfE|*OI8q;kv>PLZGpZa$>=aPs) zT`QMV5gSA@>mkrOYKAX)u87=Ba3NC>B%Dj4JVxKGmupu4YK`@mm}!HW!c|L@HJY^s z^=ooU9>;X=L1f4P8Oz_`-`kM05YvENkg05EYsEmyDA-4WQZd++!&ANSimi~#sDFk0 zdoN2htNwH8mn>D$YXLrwK8PNVRL!nDp#!T!*g!YJ4wE+6J%f)b0wI@V1Putzh~K14 z(o0~SX$U4IE`^*&=1~IEdM4T~X+M4pK6DO%hrVMtH291tu-ru7BR0N>ztMS{w15gq zxYV=f0O9s5aCtH!WsV35(TSc1*_p9k$z{sk_m^1 z*9%sWS+nzw!N|>M0ak3HMN* zRd+rt(NzCY_;F0uY0tJs?p#;iwld31HP>sm&D5+z`f4%P>$F`hu~NFCsyD-Y&DOad zKi=Ks!VBNGb4Y*R$?h5Om|o2PNwEc4e^SP8tGEA2l>>#0Pcb@6?{i}+GB`dqmaG^U8-6kG-pfkSE{rrq40MWB=JS$#d;?gz+-Z{Kvnb*@}W{VR_#5aW<^pgoM7?(4OJehK4wiV2^17Uy)3?dtfNLC6A zBK(yDzbH&!PytX$+*2~29ZY05#IhUW*-Z&|Q`Fr=N`~Y%GOs@BtDnoty;ypo6#my@ zS@qGZwFULI?YHb<9gvlMRF4Vjg0V;hiYQTp+#qS+yH7m6Uc@)G$hd>iC@7*MIOJ?UO@AX^5(W9B zKpD_cs<%TDGgt@>_;32~v_2Y}*%b7?q7-RHKMtY{a$01EtY#l-haj8HVNh^KH znwQ1n$&C}HT!G2*l%L%%<4J%YD{0yqH6Z;7eJVZC9Per28B#-c$ zP_WXi1<@uVCj|nCh7m=y2u|Tm5e8tRGjgmRN*c4?hPgl)WRSCU_)#@lp)2e6(zx$pV>@S@?#y+gGG z?u6H%1*a>z3b|h`>T;OATZa^k7rOGT({(|lXBeNj8FudS}Q%E+jZ<`X6q~ZCM*E}6je;y6xGqTTefn$Ix&pm zu-u!Xdp~tizoBV4M)V!lGFe*C#zn$vq~Pf(_5pZVxlm4Q4Q&#{%Yhrmka?VgClfP^ zm1Dj)Q8MD7Sk7ps?+j-Ij}cKsfq6;`NC%jJm+n$ytN_MZjP!m~nx9I*mx?7drUV7850S%HH7J1m-a1-zC8+#1 zR-Mlu^;I!HMWrz}{7@&#R>jIz-Eg-s;BiTG2_(8-rD+wWaf2}L?Va6e_|L^`87d&e@m}rI=g#@9KwgZR3&O0We%LKIZ*mh0Z2=Do(4uW@Ss4c}@+FY%QxAlP)t zPnb`p(_O_~r5sQiLcWB@>Gl|Iz>Nuf-zk)Fh=K6pn7deH9=v(rt>HI@XWeVzv_G>n;VFrEN_A( zK*#x>53)_g!THkqXhA)k&VE=1;X%w31O#@j_z6Np71V;Ak+lIrheXkuSkaoxJ@KOU zgugxRZ=cVHu)>z%%46sFMkCaC}K`C}c zMYolElk2Rp{;ChD-!XT!S*`>+>&(+RP9&#`Gmtx7SJKtW&+uHA!!cvyDV;$DXFLu{ z=N5IX>9-#9O1AS~YU`a{quYAqukqt;J)Uhn{yARVdOyR)BYsBGb#(CPG2!Hi z!-G!?4A3*bNn>~<9?nKvPV)E2ga(8uB(3y%(#5o5iK`>}ch~!UWDKxKZrTPUzVa~b zKB749W%n^*1KhQT;yIP$J@3&zbY(Tol~*UqTM$DzQNAu#zV7l!ynN&N`w=#yI5_E= z%!mdW&-eT&pLPu|$_%8<=>FuJ@k6gz<457oqYI}ix;?ZHSJ6K7aKDq;%~__cfzH+D z=`uT|YhB2mUR~0)nV<1;UD=KqA5ZCAGoH@mJ1AXN)YZ<c|s?Cmf z2PA}r?E=~kj0pHTaz(^KJ?}<2^_-K>5`l+a14jgskYS_-b(+(>uQ?|*@0&xGwD+y@ zhQj-bevES7TGVZ8#K{RM;Z09jRqJJ=jVsq^$WK?!Mm93+ra76(o^6bYVD z;7jO*SdDzlN3e$FF_6dVGdOw4%l;`lJm~Xbc+tm6PwYE(k>pbkY@WBl67_`1^cl?N zDc7ltQ|?ihMqj2*epmfVgjqOeG(%Hrh5A%ZG4jnn(j@;5*`DVSP1!!`Vv&_IUNxn} zRkj{kDVJ3LB3iL&q(%Nc>Xv(Jl()nf0e6Z3L>DO|1^e4)tfuGr5n|=D3o*HHq|kLh z)KmHY0D6nX9Fs}GddlP+^{=XDvn19NluM(YGWhE^9jTCW)W5)bs^nh`>#31{jXD|V zP4Vhap-J`N_w4(sZc4pVv;&M(9}OP_9T_}|fPEBzu^(X>hnt2655f=RiNWAuL=!v+ zrXV39k#Z=~9|(mtWse^V!*E6|m*fsdnje%bpn^{g56ZC``-cbMN2gyn86=(Nj^I&v zb?ZMk7~B+$cpHNQXhh!-j6a7cBU8#4f&Bu0*B6O_PKOAa`X<`JkTnR0z|T3Ukv6M1 z8@Vq%fhtAXz|p;X-?qM8TlXX#6i^_1I5NoaIe{H0OW|-y*S@{G`u6SZ-nn%@(%rlJ z9^A2Q`~H1QY@KwHwk11Sggt;+N$b$z@Cf3RFh0CZ98zX?fZ-A&M_MTL1GGMA$5_xH zB>4kF{Rpba^l=F{OuE!@NIF@XhCoWvD`Ar1G3-&kiTv0M3195PMM;#Iv_X-CN-!KKw`CHC!n|Ne$aBBYtd8XpZOY0@f)n7<)3(6O3Of79OH$uryI49fZyoIkloG59I zl{8=XHeas)!xM=u55%@SaDDXy^LZ6>c|G5I{xJic?g&+MM4k5)bW=D<|_w}$`Fa%IOKWd0!MFN*)PIM()1tmffp z(IYq9p9asOr41*!FaI^`#J*RZQEz$FQNGZ@km<}%etv)8O+ls)VdhUmW5>Zww{u(T ztT#?}yg($HQ=TXUAC6xf z9pWV)mZvNSL8^_KakT8G14%vhM|qWlARk&nHh{N+Wy^J?hGIWkol=K_b<1_YiOIU9 zYFX}Bmq9;{g@>&gvuqQ)4U{9qRH(7@`dZ*tZ64$Wuo^P8r2FALR~m z>d|f#n_Tm>RIW+=J8C;%IjESIQ`jFpYQX4_$8Z=1<+qf>uu{%Z|K7u4s2pgd z%0Z{rgTqikI@n>TAQz){b{N{9v#WH-*{qmb|=x~Z%MrX$5z3w9zh}c|F`ySYA>8m) z%x48Ay56+i$f{LxUqAWE$ycAf0SyeNDJKsB+;R#oHe6_!7?@li&u$pEFL9<2wI%U7 zI-pRQTPXY3Z;bgH=L&-p&Nm-URIiIwulqw=qHRa4ZO0GRN2~TlEB7OUPHrB(QuJX~ z3d!aFwJ9EVpTO?acd7(#&?LEawLl=L;uh6Npf=)3X6^50*0h5oyD&n7a6Pg|_#9zsp1%G8a!S${rl3}- ziX!NVsDm)ZnzNLmh^iuIq~oemrg9VILq%%>q|xcps+}m5E(@x0r$}ro840P5Hp0wc z2(Hyj`_ej@qHD4Wy*|!-d!}Y6Xbcd>qC>d%mtODap!qxewuv66FVlKiF-+p zWTDCAX(l_D6`$sQ0?AP#zbTgA^dplit7yS$$t@vsAJ;1`nES*ER$cZdS~_Dboi_@) zZqFCj%+_^80~;ZS$}M@XpqS|Mk~^rWp!nkG*G6Tr6IA9Ga#7n)7YgM5++iI$Uvh`_ zDe5V^vrvZy-U$=fJ6+c6<=!ah<;b1*X4~&)A~o%>ZC%Sxd+U14R`^-#F_E7&q-RWa ztS8%-^>(z!FN^j=y;F<~E!>!lMIa_P&*Yc`+HrlRraFpKY-J0oq zH^YqdyB?0xnFW-tv4CWMx8AvRwf)`I7JT5{wfxr2&UZK1QQP-9zSm{{zRiL9Q%(^& z3tk{qn*CTA%bp_KNz=V3(+K+*yf-*wjFe>n6^M4wT{669QeLce{dHtnUGWh`E_@d) zbb~K1M?#ZQBjBA&ZjBn-RfTtFAC=)0;7%(uL-;g007YpAbQIVk!Ve~RQhZY@} zo^>%_-IPC3-yW-PpY?5EI_e2G=}3xd3A656jg~sxNXagJBqs&8Z+T3)WwXIG(VSL8 zMfFy+=yZ8k9rtE+SC(noS%>6w3)fX+onBpr^h}nwtI{$PG*h~QqjaSeY2g_Hu%wnF ztE2nKW3pDwM3_O{^=ZBX*cdY%95&=*D5O!pxlGj>>7l<)59s!%G?44?7Bp|_8pn1= zbE@Ok#<|R#v2CPovx76%w+Zkqw>Efr(WN}AXaIF6my8?eRc&mNs*Rmo20+oqAu8Go zQha&DCXz8KsM_%Lu4J~#ca^Dy6yY>|1^>9k&my6B6p+py1I~mFiZ-#}Ae%usmvQte=rnp$Lh;J!YD$dTYfSD-snOVig;%v?e-s z#X5G)R_tcPXMMH?Q)WAuS|JcX1*SYW@_8vJE913@3`T}76B}7<`Vf^@HIJE!g^G)7 zwVHl|O8!3Gn2CU*)$}=HGBSA-`>vL^D8oYpupvCyO}(P;-xj4%sd4ROeI~+r8IR8k zy`$=Sk)4;Q-W03e6tCWLVbA%UlUZ~AvV^}O=5LtVI_qCOA844`84t8ku zh{70KR`Gn@%6Bp^Wyb5;&UYeO_Qm@z+@J8*$NcqERf!cHu@xOxKK0$teCIPiXr1*x zFz3%r_-kYS+P^H=E%OWm#TU1|yiKbMr9n#dx=@7@FE9vX^rP@+(AyUZdJ4H$xy}~r zYd)mjHurce@3eKUF;CZK;P>>J&RT@hzFNd}mpHBlcuEJU%+(4Cv3+$#QID0sW~KaV zPAl@SdH9|@`?YL4UQSu=m>Usqq~$K+jrW2bE~j%y_!YyLdVq?;aD*)lw#Jr5hcwJ( z%>p2NsGJr6(fA@hBw;~>z!b(Dg-QgNpD^9`)0Ne!-9rn+gOoPLQeM&IoyiHTl`o>G z7GERmE>dc+6E$X5)o7*4-`OK#J- zf|WF2gcnJZ11|Axra%=??tg1{L_#NZp_^`oD>GNq3zgy6N(-`=UP@y)B2(P*RNZo< zqR|;A<4@rV1}3O3b{VsUj7UYf1_BcrKmp4u6E&Av`7@BQG_>%kT^0=!+GyHT-E3oP z-Za}>9=5qZA$rSndUK~K6>y+Jagb`zsO1KUaa@&QSPm{KD5t`4#h}r5be9n&9X^7x z3dO3vu$(A5{J;|RD+r{f9tDY1^VEs@81(>k(qD2t>HTLMhI<@=<)W!9fh_+f(e6N) z33Fi=5as~mMHnEmKq?guC_^e0RFr*+i+p5e+=Ffth?`YO{2K^+D zI$~76U6k5Qw^TGLZNrn8ERvuA>0Cg-G_50=%lm(???3e= z*6xk1-8;MXQ?R+wy04M^(kOl|44mqa&x~UiM>S#T%)9Y~Gjr*-&`DwmTFkP*e*46ncd4epzs8(Zj>3MRyULT5Lgb z2J!uhZ8LRNN;g$@mzuBoTqp;82s!XyL-*3E9y5QOfwJuHaefWtm0NQ@j4<}r~evP9+sCR5!qRBjLL zm$P_H-7m%tU_etW>AFP{d^PWZe3+=fy zFA|G33tzS9^73uBDx7??DDtPueh&C?t;#i8nsQuYeUq$|C8`q;Tnyl9&=|hfI@?=iumjy>gBui z;`eDe6BR38cp@UEtMKIC5mQ41S~&paL4%W|e-p%%!f}N-lE^QCqW&I^#rB^git3{^ z^#k1MB}Xu}<8aLZnK!abGE0tOnMDSRQ$jb7Vhx7p@Pc}Lk^{$|7rI$k@_OkjrHR7T zvBK4f!VR&)4e`Q_=WXyamj%2Ig7DFi%8~2Ig7L zFi)hLs=6!9SF@}XJ37~eSkPC?SnTL>cCV~5ju%ZMEnmuJKK<|br!*$1_~#PXXTCgu z>R(lKvLp`rC2Y1Q?uvs7{}=5MV>~k7U{er6IYv9;%V>$(4jou3_k83!#%)_%T!C?Ak)grj&*_7xy)M*GBsc0?BQGs_6esV?oke zh9^oQTrp}3^B(r+^hk%({RQRG?J*japADzW;!AGTIQb?Kr=!YJa60^^i(4cjUFBhh ztdbNKp1?>7d(r}-CX=gLA`rv6MF}apc7v8Zp21zImZ#4PHWCGUrY;@R}CWk|o+kM_c$;6^gwErkIuQZS@nMTYc2 z7}9e{PWv;EI~^?PYUHOkaa~Yn+RP(8W1)gGyo1u7qOMwgrk3S5S}A`O-_>rPS!>6; z#ypf0%k3YH9qzy6{$czHBmEx(Ug@&@iFNn9a}-0RpX<&!vE0sKoX7NSqnM8fe?}mA zjBd!q-RW2aK`MQw5zDAil3=s`Sn)HZ{oYw*=JVU@$McV+kZ?0P3|CN zHVUORY!qJ4Mp=?&GDq`9x3d`VMS}Ju4fOKCTNPeDARd_X_-8&aHQa$T*!b@!=l_l; zr;x;ar|*Bo%2{}x)(qSKOW80B^C-e(=(+>4Qbl>wR)c&}{-=+#^@&tux*Dk`CG$O# z8xO2M-}7@hDTTkHJ%WGAg-(c^mB_!rK?d~7=orgTTBjt`1-K-k)AqmlVfM@?I?V3w z;YIlC^u^51uHbTunGUfTTFI9%*7t(*r5<7h@)0I#3C$w#!q4*v>!2g7gpRNdI>J^G z##hELzLmiET*#d+E9q+Br#Et)TO8Ayc%)~{RB*=XptQTFtA?McVfhVK%7+`JHv3Gg z9q;ZDeuyCzJx1T8l#b^6uarl(%NRi6Z|E1Xk6Bg{E(Z|Go5kx6M}iMNHT-bD@ObF( z0J9@(RN}ldbFn9$fMaD%`J|hCMD5&j4_tzMBAzat*j zYjEF(2cPci`!6(le@unbnC}=;QIlpJ657ayM*b{ivQ?`XEJx|n#JNq{#BohyPmkdn zkxaR1hldZ3^!5D>Z4DwN5l=9$xA<&Y zBPlcD6dMV>#rLUwM6^Po7;Z^3&Sa2l(i@J#Wf~}sC15XJ(_cn2D>qQq7?YZ}o!a;! zD$q_ZWk%d$^TaSd|BYIhi(+UYR8*cl^K8Of9`lyRy_Hc%WqLDd(Y-)ij^9K=VfABm z=r6fhLdgg%6Lx((D(fW4dC@%mwVZ;pqR*l5I+%ff9k^_ErvG;uwZR68jgG1h!6r0{ zM`SWsN{5AXFj4ebmmyUU4hiJhwIF>PG{OEoy*~#vf)W92;(oia924( zs`fob%!*RF%V-p36=3I+&Dq)OXVEd5GC!4@UTKC840R#2|rC7yu`zvZx5D6krIKFbx#_=_DE23M~qRq-z z-*R*O2JvNjWdQ$_i&j4_Zt(%!HSnAZnP1}ott~Iw;QwFzMd282fbAXz%X$2zaEvzi z^(RAZ3e!mb{v9DPl(O@rtKKJUL$$q^xTO0)e|Q8&d|!C#Fc?4b?xMfc0=5QzcAyWA zX%>y%KVqa(WGoE$yLZ82P=@_K#&{XPergD9YSxg=Na)Q$n0ck#Y?JEMLn#c$$B6B20bZ;KK>Ctieu&)3C)b5j8to{v`IyFq$k0*yD4N2p^AlP3W)=S2S zV(zOlh_xPcjufdakyG+`fsxGO8#Csv!MGeDulu@7^~%Cbkj=`NXq6g`>LL|x-KDLI z9UZ@hqhl1bi^5U{>p7b#>=_7rK;Hlyg$=^@Mo73rMTmlB_RUH7H$zzC@SreBl@NDcU_NK+ zQ39+ew!MEHxk(EGnJ@*PR3-pikcp5nA_6Pv*FVv2UyV8>Iw|Mt+b-_9uHsW{QDWMj)C|Io0#d?qA!@PVKf>Hr&E&NVqpd-5ci0;QeyeT@2lIe?cOr`g%_F zg4vo?G+$JgDC&+Cb;pagCj48Y{;eOt*H+F=xyp%=>lui-QyMM1Kc2la>fZT2A}H*6 zV^6%Qb=(5P>ioX(lVYT6&lyj`Q55|={cu)egn@t zOrDP05F_XIk}Y!ek4$EGA%ngoI`;KFb1)?4k#Prx(Vo1Y%zI0IWa3dDB1gdqSi&8Q zxr3AbS$7R{VO|#VmQA+CyzpM*zv#Z;{(9z3ch*7%Uic_{2*Z84Gkfa_ZraavZ?R72 z=2N;UzsF*lv2s0}b%wW6+S%#FgR6ynPo?QxWX%2LiVeA7h0mK`J4kkFD48mv(PX7qx1{S1KCj}2n5<={UO zpjov=TpGAxlVuorECFa!lsisy!arfL!=udd`(+Z{5a{HTk26~D+QT@RDXr?h;bVk< zMRM55mYP{+$4j5Wn}lQCeYwkvn=E(Lg&Wf?+{}WgqagiMM6bk&BICEE6syP+j1@(iJVHgpT@UoRU67@Dj9S!L%q2<7q%ylG| zYKe*x%P^Ta>(n}DRb0+6l~e!^{RPi%aM-EXOq!P?JmBLvKh;&vsM$z$RvUGJNJ^{d zUPSpcb9ob~-+yQ@IPjDpz(qrl@Sot}FdSQs1P>h>V$rfk4k3dE4-StQ6lU;v64i+C z_|GU6#|^el3Op5P*ivmy{u$FMK~V`PH_==?hBq-6@*;U{^wsCCXEbTy+f8V^l)P4Q zX2*EX`O3MRyo;MIZ2F}wbCtE{5i$Xh5^|W=tdUt?)qB1?IL9igMR-6&Wq`*UgT;k! zic|U~5=%{~kgHBA_A*N9FPWAZMvP%d#|gHu3#I7`x=UUd@J;KK9~r|4xn9`|i@e0e zu}^wCNwIau-u;-U9m5BX32RZEz+~!EMT{Gw+lqIM7(TEs6yMra zqi-?_2mUtXXl!#$tAA_)AqHx3)!HAMEc`BR(G>(?*26jZ!o@s}Z(OvwAV(@N;}Po( zt6~6kDHj0*T-@TnOfVi_V;x6eS3g~eEkn|}xO%EfPXs}dq3M2Wl z_6;8GKYr+#FeuY~TWIBp0Qpv?$(MKTxiimA48*+^QAdRckg2(J(O;?(^>d5Iks$Nr z5&RXeGuBblSFjHWsefDXLIm`e&Rn?;iVChF2;qT9a~`LAfWlJ+STk^0&k58&geH2O z7Wf!G4K5-Z+sGa(RWvoqDSg&_7bM#A_}8ryQHf-pfu@q& z2OXJLt9ySFBS(!}YCx)KTY8$j!6+7CAUSgw$+&D=9@P+?vUU?A_25l|21|5N|Qw}jY2oTy>0VWc%`Vj4spP~U;mgz*+ zm$!f=xan6!)@dpc2Kr^^mv>IIAcDocet*#*59p0YPvYTtKBrchU;2yokm~~q}y7MKeK}GE;K>^u{$5mHm#Iy zHBP&#bo5!It-B{TFPQjoTEB;w}_ zw1O(|9>YnA<33S-JtIIqT;0WR9CR+@%Nggt0MPqY1IdqaIyC~aFV({@RvAMS6aM5-%3gHBugycXLpp4~SQEEO@kk_+)V8Fx(D{P{l4}V~WKI{w6BW zQ6U1cc7$9MNdXv)`p^Ij=@U=WbRR=4;&g90vn85QGu8S|$EA)dRo`9tot4)cb};|F zk~{aCFx}kr^-bg5DjlMsKhig?NRjxJ&_&_LG$?68)sOj2Htzaw5;_yfQNO9+KwqMvCH*WGiI(C^M;)c< zZBV!}v{_TQGN@R*u+FV=TK%g~O4JKn^4M5}9r&e^Lumkj5kP*m#VQr_5;d8agv8{i zcyrC<$Xlo0I2Es48~3h@I@YnqgWtl?IOZyt;c~Q)^+eB3R04W=`I0l#&O7w>PjLg# z`eVwV)+0Uw0RxSjU?Uoc9i7b7kS1P4EU9zC@6ylT!;LMD`$SJO)Feh5Y^GkmieI;3 zZ0ItTSI?DHe2`)1D{tl(E%5kD$6)D#lTt2Ieqe!~VF9~x7Cn?Il3&T-H?ddnS9*m~ z^vaJjkXkG%;Br2V{TRx2r{LN2j6ysK+6mTLLU6};&&$g`taL}zghV0!{2QD&cffE zP;n?5fBh$O>Pv)fbW=pAwqZ6QwHi4#0zzx#*pq|9VTGQf;h~YiKW_08&~u`&F6q{O zBn5~v5-z{HA4XG$M^5fKe3XQ>G9mXhf-|b}h8FTunl)|@652g34-@Dt^iRB0UW(=^ zb&p+o4yq{7litC8kWT0t5&3=JqH#TVh?sF^_PL=mLoW?O zK5*Spe22m5)BaNK8(gvVqOFu0&;neVKGq9bTldlnLIAWaW`Js(T1?fdECF&m5Ggcj z^fRP#^B<_qS$KoBSv*4BXWU=Ol)N2f`%@828dr??y&j>(D4TXT(87om>zkzA5x+{U zA}+iXVVzW15Y9wA*|e*k`pTL^M}>CP8%6aB2i0|Ngw?6|6~cxncwGuM2oBVf_&y{D z8Tc~0LQ0rCNDhb{!7kcEMxLE1vQtR$$jro}ratsmddpC}D{LP%3tLg2f#}yr*c;;C zw#g@V$V}2(il1pjP0L#XSg2X#37|!W-w_ZR1^8^Y7z`NLqC7^Yzg(-b@= z0IM81)O>jO0K+LGg@&a!Zwj_B=u3JM)*w|xC4`VS9LxOKT-L4CjUCH{yyMs|Z5@bzZ*l=U6& zC2zc{E#_^DI@;3bM(HE*AXy)k*-<;9_EFxva<4Qhjmdy4Sv)q}_xZs?{X+-(jvbK5 zZ&BF)BC6CLZp87Al&1Ael*~(SPE)_KS-+tFm~hm^9CdFOf4lUC+#Br*QdZim*c$?f zYB!YB2?C~6mR%{p){rC#SE#~b;~M4hz*7U3=98bnMB7x?%uHG+e_r$VZUnd}+1tt_ zcQQsqVm(FKLK5vA8y*ZEI}l{$bfa5~1BqdoV0E*lH;L~H1k%J^#vmM#Y(fwVK|-sN z4*6>-xYZh(z6RX~;NX&}ob?&3f@?IFkDzj*%5%<-Tzvk*^RbK?2nFYSkHDvTPUeEi z?8yYt;r2n#0{j`K^ta`WE%CB7mq!xocf{83xL(F6caduYRoH|h04MAd+iy6kjhFWe zggQKcuP%q;sLMgW#Pz5fi)dg~(I9iuZ`5Vu6;C)`Bn{J+-v0|4o-#C4#N`muC$~A4 z+x+(Ex1WpWZccasyf;U^n52sRlD$~3bOmjOJ)yl3>bfYr#HK~k$Ez?}bF#kn(4pvy)M#ziY z9x^w^ZY9W~yGA)uwTBZo^K$45>kpu(*4OXw3SCc18LQ3U8%BCo@Ts8*EUs#Qp_K|7 zUv26U1E0j&d3hALx|W465>%O@lU&BIr|m1MRDBQCiVSLcty4NifSUq|3c~yzLEwQ{U@x0E2uQTTBTqrX+*WX?!HDz@{%_%1c zH78G=qNX(G%Y~YgC-0}X0w!P4k4#SIig|zF;_eH(U)~GsroMT+C*h`W_Yi?w7evuk}?ZLvfQ?oh_!{%%R23{QaaO&XRyR)b~pq*A#ef4Ez|cHVybm@BcSi37T`hJmx4Ty}KKZ77?s#&v~W&B14`z zT*Tn&FC%ED-6O`QwXjbmv`|7{DSm5CdtyiEE=H`aGOpW54>x3fTOsE{Rz^AjHW`H< zl3^ENUGyKI4UGi505@Tdqv9zlR-<+FSkLc?+^5GMhHF)=AY#hj4Rz=hYO%pZuDw$P z3XC~l0mvXKWa{vV1}gryXr{0MsZ?085jp9w!e~+bJ*|+hq82!@HS^8_#qntc=#j~` zS$89p9A(7eP0M7@TYKNw8xOWBh(mD4JrOyO7xJd^`?+XFfZ|8^3Vvj=I13n(@*qP} zAS@tYQm|k_{+%!#RHp--n@rQ2^15;?DI1NBHFS_${2CG|yaGeg2a86TP`n^r>ZBSk zDtS4kEL($xDVO`U^bMIDu?uVPC1EAa5>cf|o;l1DXO+hjsbDfCS{3|n7d@&oprwI;>rsvS9}; zl#i%g0x?TPW_mZO1#+t9&LHEGLpXy!!h=-o%aqzjsh224@nclGbm3w8`3T*JPmlW9 zNtT&XNM_vA;MC{p8TSlP{vo}fvhaynClK>XbQH*1_bB~jL)$`KU`kHxO6H*^XYbu#`C*KAo53`cx?CiwQ+0lq7|x7*(Z#`^pv}hT-^^}Y;PDp( zes&Fn$4EI$S=9?pO1Vs~%*6~!`6M2F#iGo&uOPmCc7iX6@dZCJdr&c+6fRH-2dl`@ zuTn}^DO~<`C9j=~U~qH7CI*^UTNZ6OeBR;;j$gfK%is%c71?-kPFatV`F)|m1N~18 zjr5HiV%CvEBJVkpFPT&7aEK=c(0%2SP6Tdo7qV2T0UUgD;Ivy5(?}O{@Xe=52{I&8 zNf(nQ*rC)#<~3w0=}CI~_8mSr+&}c77|B~mVan5oF;mdW%WT9QEGleP~!z+;j-S9z}AadNDfQVsI2LuUN zPzHXxXFgX6kJ7aI+t6x)iOqa%^IOlo@m#!iJxaLen_Ip;NSyeRbW8x#AWp@9L}Do( z%{|}&$`qg)=~_I(aLI%Uuxer>EQKre%g$u42~c5yuUY4C($LT%CJ-U50a3a5 zMPzEQnxwO@kJ+mB^%+g6^r)KJL@*fJ%$p<6hxViBrYKumK;n~eVT>V7xJg9|jd+fl z<3QoypeBQjqi|*v*`)CojW(G46~+{M1iYM}${4e20`f3er#oAidw8SaA0B)LQbNPw z7a!Hp@Y6z9xdyed%-VQneZm2~Spst~LBH-TpAS^LzWJ5S@j%0P&)Hq%_PX&xBLc`p z-K95K8OZn&-ujrgKF%yf7BWoE6%@A-T6f`ceBg9J=Q<+SS6g3gLkgb8I$N#N{xV9p za=4S_@pephBu8{Iy-z%48-vZw%})TYBp@zS(~TgfFpZmxS9aqy;Xd5t3@VmxraVUP zF-SykMxf0ie2QM(N4MkjlN5kN&I_xPZVnovUgVRRGS9azW?J|ai!Pq`FJ#*J)eJ?% zUkOE|l!ziyN<A_XVHyUO|E!X`@9|6cy^CN|!f1-2TNVK<0oD>Wzef*g`FI%(vk3vg&1 zv)_;Ck#Y`Xsu(@-I>STz9P)LolvM_a&@$(Y2zt3508gnscME5xG9`cwDqB=!_ty*n zGbRH|**1iQtq%4hlJ(K!Lxb`Yh%o;FO&0!Nx;>6j6#j`)iaNW{j=ZGf;NVE#aR1T4 zr2Xl^{wIaO14#>R!WZ!ndQD7+f+UVYE!DuPd7FMRm3EpW@c4qkF>$et;di7!XSt$a zdh2NghEe1;&b{37L~eB~w|X)Z&utiY&1K|9Gbjq`nH@I^DiQ^av4Y0&9oUlRPMtaR z((^EL^yWmpWl_hDX!(vf?%uL_hli=gzm`4G^J>9l`&8(iqnD0;``DF{Sx3)&Zt=y( zFFZc!kLT7vEnXxsQV4OH2rN2ou?ihqO3o!u+%w!MF3g=IRZHz6MHO@j+)1-4)JGW_ z7u}^UAR~w?TXYKnb)S9RWs+s&K;W}{eqJ);<*Io@{z_e$i~ z#`0_5&VQ%$Qt7O_4g6u5m%Ae7TQTcv1aIg4!sjQK*4;tUavZ8d@&rz~2?F=~0+ zEW-i-eyWvS2Z5xjOabNzgO{H%rD{=kkOXh=1ZDuaYdq)UEo zgaH7}MNjmXe7aMOGPTGH{WMez0h_=J$y|750)0ZE909K+{)mvwPS4Y;tccX2KV?`Y zLXlb%Zb9{ocs~b~I58;stRqOSpJ0yi5~STtF-Ox>DABw%*1UDr(W{|9Bq+c-L_@&_ zlq7l|XFx%Ko8iF%@6x5w?+}N8=0_OEEftnCv{biPMDpzzb&7P~8TkffdDg9xn4@Ik z(3Jgho}$NrrK(&CgH6#&Q68xYBg9aiZh7L&VykJ+(k6m3Q<_Y;5$*M-smZ|kXdZx) zj1t47D(0<`QO5dL@H2%uVm4}{Dw$EGH!>6u%CIO6@ChTn64d8d z30~d@Vl`NF`vT18vwg&$Oz3|Jp zg=r{&6pA?EAbv$kw5vOj4+<-uY({+$it2i zBUi3W%hL!+kI}a7VUjWivLowugV}u;XnRl@mT>Uc z0JGB%L5ETF8hA)JHhk=g?3Ji%bcc(c?dN^g^bzlLjh;5VP&GBBi7Jy<-w@CZv6fU>uf>YJT&Jv zy!8AeNbJhFyx?Tkg`-hl<$GCy`MkP0|E?b#ftV~m8@fDM+2AK;7sGhpT`bO*7N2(F zQ!mhbWg=JPk>K<+51EbvZw2_})&l+*^CH+2ZnbHRDP(#UbN&tfqU9HPUi7qJIc0@J zSd7N3d3K7&nXE9*@onjnVFpx9>rjGPrMpIXb&s9h04~Q`{HurbRUy?NeO-CVwtW5J zLb&y|8Zq`qZANOl6n5-1`gh9qob73D#3wfj-`afFZ)M?2WPPo>MinJpkfa3S*fnZX zg9(nB4=6ZEm^*EHRBFN5-<4Y;Yn7}c?2Y{=uXxTh?AH509kx7UdDQeYup;_TElJYr z7I5C4#!Nqoo)TmdOA-f(!ne~>sppcuy-$sR)E(R^pSB3g>gzjxas((~^D*&RSU8G_ z7M`HnpW!tzj5EPy;R@Z7bo(CNZqSW^J%V^pf}?Ge%#?iNOBkS7+uKz1hxFJc435C& zO7tC0D+u6@E(Y>w%RM#RN6iWMK~B-vsS}B#_Nxr?}f2WaYZ7~5DPTi2sF(VlqL%5 zV+Hk7H8%=c7RvF;?VBaFqPHKo9-1S>jLObZ+3E?~>z-FUli|0XdE=Q_!K$17!k^CP zSHbU3R%vQU)Jl~3)V|q*miGhIlLK$>h_2rjZP-2=*fCd7a?4^WzMuQ)f)g*^`5?8|2mg+;3EbvPUrB_iauD0_%X8YC6cBE5SP_$ak5j6S+ zAg!V*h)n$zeo__jsVDe|a%!uzKk0I)Fv4i(A7G~ll~b_-@)m=0NP$$0Ur*)|x=V&z zhWp%Pq`Rha^JRFZJ?{XWfcqT=@g~=?0&}Q7x%lg;r(D%3=Kh`sU@r;W!eMQpuiMub)wPO zR);79ya#Xax;Hq#YUjK!_v?q>v|Jc|^Wa;wdMVe%kRW5nS7$M4d zgEpn^0?SI-YU(5PXpxr^+cpM=x%@>eHS0IHi=3q9`g3g?Lu)?n7cI;A!jOB7W1W~r z>{3C>X%5JW!ZZW|k;7WB?C3m-16e-mr6V~~#rSf;gM(na^dl^3P&(^^p~E5OTq-;Q zR>^UE9po^xlKOM+&QTaSh*`P)R{(v^<_t9RqK|gSr{J~gG{bUVp z^D0 z7OW2EHjd=IaH{tbR70C%?q;@c>tnw9sk(QXFEwAOiu<+WP8v?QaS+qax1U&W71oU?&7s4nKN`ynL77G!)BUV*Nh?#%11=cWtWyIrQ4 z>^7vYx(d5%;OfCl>1vMBH5Q~(wll#@%oDfxi%2j^>SHce7Qlw+G2J!F9pGe;ATL?w zr&BrY)E6`x)gsgLR^6&%%SmQ7KSN84LGa^9r7|estsQGZT2YZa4XoDWU#At&g%*HU z;W9y5SaPA{WkkPS6U$mN=dLCl;p&*XdU7b{-gNl@ZkY0H*SIZp%ICbfhFXJ5jwr9(_)&o zI6D#7*d6F>v`jbhNCOH!g{Q(F(v5Ljng6sC^z)DCmL?Sb46Wh&=yny)!J=V&mXpAH z7_&uqmmsI|7W1@*~_;_sP~@*qQ-E4**P zLVxf7H2aIT-s16F99kOC0SvTqNx+d?{63zjVzoh?2u&1Ig_=n1R6evGvqJFJOo|Um z4v(Cbq>8HK*pRb|lu(r%J91h`9aYJ3upB6+DmhM;0}t>@jte=fQyg7n3|a==MozM! z6zkG@GYqYP=+36pl!=;FlJHK+@gk>{#CA%K4>@Z|Xs6_4A!i+l?3A2rSaM7}|Z zjiG!^i2~HRDO8}zDNKJyZd+(`s8Ca~2=8tQ6=`w;^ls=rxxCbm&QL(pk7B&l6)M)e zRf3%EP>Cj|l;xCaa>|Tb73v9NPoa$k`oQ zp~+RTPdP>% zMr80QyXr(@)HZ5=+b+Mk)^y4_>NLXSfK@7+O2)~J09Dg?yO?3J4kW&?^<)tNt|u#x0$q)@{e_OnV0kD5q1!U-p&XUu1~uRyKNQ~FEEQTLgrFaF+-6kl`#Jfq z*`PPwc=${SB1|Hi;O9Q4W$3XwBiZSr`wujjFXDxtKvd~7 zxxC{eF9m)KKajOBcyZ;DN66X*zbUKWV#bAxiEWend`4ncycDHr-p8LIK>Y zdgjK2r{lV(L$vyyZp!QOSY|wYSDszbMnMDBSSoq=p@m;Eq>?FUPBZ|~MeRy@Bv;|0 zzllh(ZZJ}wI{i3nYsKRgo}ikrAxZx7IASwv}dE*JR;a$czM* zYA75FLZ`?S_T%evI}_fTn71bGt&2M9L~*3H!IZ{IfjClZFz(`|4jq9ueLIqcN|Xv! z-r6?+w=!Wxk4@gOOP2IeQ?c4uQ%j<({HOiD53^jV8^DAtES|bgZ?h^d!d9d7|3>V^kx9(;9 zgnA_z{wusvwFGGzLqxn$GQ8C?PAnwCRJo-%BUUptcp7fd&eTj%N%Fr_ssaNoY@i#P zhYU*n4?Mszz@QpC3#eqOW(C>oM{1UwpOkPZ1vFXDpbGI2@CIIbjs-6n--y5s0PoJ6 z`9STIH5O<}1UAG18^(7*Sl|uJc>~afzwWJ{&kIa+zI=!r@XuwHB(kcmXH~(%{bpH1 zqO3hu)_&d%!&ooOW5FYVc`WD5c@Oo19g=egbXyjb=iBk|)0v%XxeGa+Ri-zKk(xGf zoolSqT#(WgX1Z57I}y0MiKSO^lwM^;ehOrxfo2Pc`jfuyp+ScMq>FR{RLPv`B1_p3 zisy-RSv021vlM>AnBUet`-KUbDO#V zZW?H+noyfKRi1)L>kmEE^V#_m+{<<6_KfeLGoU8wsh)Ee-ImiIg@btGv}Xf%&f9GH zCf8_t-P&yVmU9F5HrH(V4Sv1-x9l5I#hc554^_cM87w34ahf{)Rn&w5prxARVRqJk zQmcT%#w6m`bw4~bICy*&^^|lH#GV3zY<+16CTif1-x1EC)?UGhN|ni{k+$L=o^XrB zNN5ic5>=|+;9*n%r6zh?*oA_E52=*hlgtsd=p{AdzVN`Y!xh^vcJ4Du^=zZuQg$3b(aKG_tX12 zeHw_UmjCjA`B5O`vWQAVyfZ{#ON5-ThHn3W4+;v{g%`KO!vfiu2zhi!Jl|xVb@yAOe7&e(Upm&wOmxJkvky^Y z@Q*dd|I*XrnW=3-r)hx1K`KH*3n@kcz~%Ey1ZqDB#2MC?JE$Gn(uvWyw=wDvt>sc! zOtc zb%LSA%Zu-nYt&^F$WeY9y|NuCliyYUj=JQ9ffCLmUu3LSuELQ7t2<$f@KA!4P&G zX_iy!-zTx!1#Wmd+Cr8Ex=Z<%d(?eoweBH)9$A~7hmr>4qZw8Ak;?S9>XPJ29tAgf4}PP>CtFR zAiMwUJ-3fk^L2G~b#+zsS6_Y4Y*>w^y?Qho^I+Y=yYB5>m^Yp!j3(^k*>@!=3Xj_p z->^khPF~1VP0e`}Y~%S~8aa-WrpILvM+qVjqWT^XM^3#Zi5|2X`T$qRMB=pDO<=d!VR2 zSkyUbn<;G!mNrj1-Ylq|DQh^{aO#fJgTb<`lQ%_t#d_S-k`r5>+&XOw`RXFRvaqi$ z;A?{(_A}0>oPV`D+_EmvvM$)t1M`QxCGSe6JW8U=8^dKSfwGohSsOIC?NUj3xVSM; z+!!owp6q?Ic=0S8HaDNV|JkDp0@5U*8+4u77gdY;}FO zdRd@)+2poacRmBZhTU}mciqW?Q#Ge8r|&v5=&wg8qg|1*>J#Hvx5|=dl|OeSm=(TW zS?%vwiR7rb7Dphsk}HyhgI4*i8P3!_UvU`-UeB^^smOTUD{sknz3$5(T#|wO1PcT&VYo*4E>1w>GEW?7?MuN({bDz) zz<^p)52euX7}B2{urjgZ=r?`K@@ENt8f}}>S+5Hgshn=%B^&pP^5g4--4iT0Wa5?& z&<-eCufUJ;H_Q;MPr*s2OM;|5xXM%#7-=4no+G$r8V-XSsw3}ooJH^;>aXj5dC{5MUut-@`%Ia?_LgA&4!?T` zY`LEpe{4MB&WB+{*jE?u)lF=OFQW>N`^|=+_^4$R`RZY? zGoU;Nti}V>I%^Pzv1WsIO`{NLPyp$MCEbAZCro){NQlNQhBPxBt4F8dj%Hlv`3d$; zI?8@LBZ)evc={s@1h93qY+o?Tk8^|cV|14;H0}q#EM51do889T*1Iv$#U?{0PFrd{ z->}RWH<7XgIquR%BIzgH)+pJYQizVN$1F*rV~yOqPJL-CIg;xWBIXK^dx_2lxz`H2 z@dWoQT?CtSHXz29%Fxx+hnPM=Q*||~uh#>=r^PxMC`2CXF?_Jlpln#R#`rZMlCFll zTPZ;ym2|2i#19~vxqo;_qsO8d2-;2yD#gs&Yyu-hbNB8YRr>Z1kW{+oK>xtry(+iP z#wwzGz#8(8FIcr)lcqCtg7C2>+zamtxe&44n$={;*Fg#7YKy7}3b^YHcOxt& zA#0!URzbLuwN0MMuMFqc2lDH~`O5?O%m3bdy7wn`xIR8J>UVFY9xBRwNUgWjdVV{y z2`zrK+uK_rpDnOs+ifA;q1v2#~Cf7P9;I z>*|?W?~nA|HK2T#1Mf(sXsyC^z4AlW_YKzfO(sIx|9#vbxNZsAzDkDXr5$0-kilRn zrY-dYj`;m}1jPUEWoJ5?;)SrN3HfTL4+nEvCM;0JKi)c#5wYhy;XLO2+QzVNS-`g} z>{}V|tvtOMw)t;*%AXz&SF8(EFw7iEws-xoIzD2VAr-)7=F7HZepix~k_n5C4SGrlPMoBtWHBUTI(~f2W-L9%)-QQ! z0@DCpka`$aWU_S3mQJHce*)0Fd7*9)_(SsC&r$2w%~XT`Xo4mk2g{J_q5-CKDQ#9k{c7SoVl znA7<)sO)`c##?Mz#WU`Lu)8DR?g+b=1>DO{Js5I#N8Guj@1NR5<)1g)4XWF7b5=1g zgOH|6|_fuMRBuK*zsY^iZa)P*MvtqmrFl%PzPRG)LmyjTW1BV zoZ}1HlrsFN+i9^x2y{VOUH#%SQoeZQNBq>q2QI#M@s*P@Qor(b;u}}aqN~y=N2%M- zq%QHZ2e#t&Yv3+tYx+FznKB&3nm!MpxJT;f`hMYrJd@)!K6POxC){Y(h3t)y9Cym6 zs?8Ww{fSg@e!@Xcm4M`HJn4Pp-P1MFp}Mzv}b zCmH4v`|wZs9d;o1593E02nBJkIF91bzYQhNAjs0`X&4e`ka%p7I8YNfn(8r{AjS-X zbfx;EgFDc?h(d~SOTYZIdE83N!vq&j<6a-N4OJ!8k|4A6=cxP9EA zd#@8D={4~7p27bg3v~$7c4(`_IeV`%`2b0STjjk8bXJYVL`}mZQQKW3hY*rWP;$x} zEK8giEzku+hxZ*)hW8JQj6gSHU~n+1PyP|(!oULq`_*Sf5)XV;f2#5pAFb*GMl;|i z0AXeOQ(C5)j+imiqpp!rcpKBq{G(YogK0?e>42hWr>dqPNl9_2$D4xB;R##?mR3FxY1E66^!5n766HQ~~gfzp+c z+(Lw~xPD=9$K2AI4f0R-{CH2O06tY{8yqTF;oq?fI*V&>`sqVIekfGfbaLbOw!g4F zRJh8&^NxwE>*dencdy3D%U+o&vI^$wv5>w8zL4i00+37sC1VkN zX7|g<5*dTs`Agi(BOUEvY!(e%WH@!vYbHej;s&zmp$9kLQmM^|%0t7$gOwxq9LBsl zGE~X!gYpiyk)NufWpF)=RU)10y20I0ogyrhZ={o77ej;{HcSJwf{=w!PyPa5iuk4}lBobQ~y0Gll;3UO10duwM~0 zjqpi8ET`mhxa~~XLkZOe>~x2yKQcU|Y~{tJNH9Z$MwR8B;gQj(g-d=k%cvU&Qt`3u zS|o`*t}exPYBla1-G6AIB7pidUMu9N51}anCt;K;su6_YYjt5yb-+{o+#mTpodMU< z8PB4irzY%K7Vs>aahFe9ru$DF1tZ(Ld`?1$uB!~uHD|R}WFqX=gk!P`yjh1QY_AB| zD?;|FnVgcT&C?GAbC&q+OJYux)f@YcAFepXZE9EeVo#ZXWv4n4J zF{wV6Y*v5`%C6)om`<}wf5W4uV`&3z9z*!dbi5*nM>T>A;!#sNpBxkB2@C98Okc9= z@6VFrgFKjx<*b_|?kswSYmf%+e)XRIX!W$GW$;h_T$80??b zgMA10_4lo5=Xc}Aeb_nC_1?Nb>$)?=q1J6;pAN|zb*EKL^&UJgn$dmJ-rKit{XnJYLT_5*Jh4m*hg9V*_cW0~$>;DJXWcjKg@X0Ei zscCwC`?K4FHA^RDI6e?t$;^}8-`n=Ww$n8s_gZW(!|v*UyE;^}E#$sAl3#El<9LP< za|;h*%&m}nkr8PNDr?>kM!NAjU-I?dAWzBND=bfSn*p9J%k5qzoo#gyUe)dEZ8yJ^ zBlmi2FS)IR^Gvw#Qb94{b_?KnxQO!){~trEs6keq!2rIXsl!@Euw$FIe(P$dK)w*( zj*QZ}`Fd)n$z@h>pmdcjnBOG39>fC^$0us)-*K*8z%BEd=+j7XPJN?|skTPx3f-98 z$f{}hN38SPRa@G5%1BA5Su!A+=As@6PKhe?_ycE!q(1~ z4v#CP>3LcD(}Ca8-Uk^N6i5tGgx-n_QovBRn4gbr(q^4Ruqgi%Jr4I1kob?nFCPd6 zY>N609vFNunyC!X!z>qjNXP_@P^fiuf8S`|-AdoVy)g7TG>qWJ%3_Y*Yv@6NAC#Z+ z^q-L6PGSn>U+@^k&u77#S>jnF9Ny*?gL>d_h%JpyKIkf!hx-rh`*CztRzYx%r?Buuk>Rs`AURev%2n!cvA_aF`oud zy&ZiH>%YpAC`rc6DQ_^=`0?NNPQKeu@V%(S0mM=%>NYxg@RlGAt|_`Tk%e!8(*jT$Jd12vFaI#b{Fz3dmVgY{jL-H6F| z;+7|Gnci|r{-Ntd*XjO{uQ%e$Qzh@A`W+$Pt&!rA6C00j6iy0FaA(M8)&zVtA>U#! zpb?8NxAkQ<<6_R_hX6o}N*PphYxg8tB{H53! z<^#E#7_|=^0wiuAXEJafscx3PBR5+9yR~^fVrBq1xlKP8w z*P_2vD?1otW2Iv!svU&x;G(Ds6!1=IJ4df$f}K-?JM?{YQsc?Ux=kG>=YBVL``ls{~r`>~b5O~%Rr=6Zsqu6N*w8#+E|R*b}o0(N@Z)h(ej zgh=WMMv1W-MhF$`;M5~gm)Y<*n{Hp4C?~x4rrVd|yRoDbCg^WNb>DPOPsr>61*yk% zwtSR=a$-s)tOe;GA$bSSnr;O94=eRQVx`u;UP;25S1d~hqG6Or zFhpGmCOzuvk|lVNFc0P&bRUIS5UohKO@ZJb;}7hgjP(73c6?QD2i|MEn$Jt~)_NJS zT0{MIIcBhmFy*L={?kVW2Ep1IRvJ9&Quwbd@GJCy@*F-YRSQ5!2nLCuj_~R#US&V2 z+u{v`26^EgCch&FuIU?k@W5~@bp-}mRfUZM!-;2UiUUfVPw?Y*h+M_y**v`OUgcM; zMeLnhcwJP=l61$QwpAEjYZS4H0isz98?hIZK|ftgEii|lcl9g8220V*w0mmAl18lQ z;>8J7&xx(^OvIp`s(yMT1ozpVyc3O2HXd)D=$&=uKe6`M+NsWvvtq_mJ-t2X>GZog zRTFz`%Av8D^<>uZoC#~p<-MImsuqcKukI$($`}72&(l#>T`cP_b|rm5#NRqNCkS!pr{GxX5M z?*^yzl1tv;u)LIIA)K3q{Ff>!*PF~Qtu+CDS(X96Y%&wJuGwHSzhY+oD^{7Xjrp%Q zWZe6TGiyVk`ISQE{D15WmiT{B?5twrRBZMCI(AO~)~VRJi>MF(kU0V2=_vUf=6-UN zEI5_quL_i`yh~)7igA_qnEP)mWMEuzk0=R6ZPm*~I%Io9Q3Lg)N4EOa7l~|_eH5~7 zo++shmox`Tnu8^+6WgwfYzxB9l7JKFFXXHwy4@D^2rh%p1O0^PwzO)(HMuijN4R8* zqap>}&bmvdcKY2_ZxZdk0S`O#(QR|2qzuaNuA;Dufw89s{~5>}=(hPkif&V%`&;D$ z48goTHtBHW$#Y);kfM);{M17y(uBD-?-d8gm0B<<$XODHK?p*-L(fd>y=fj{1w@=| z(v5A;JN395d*W_1C27v~B3IB7y5RJ?xSq__RKA0Zg7!>+o3tL|h*$h9QmEq-i!ECVI3 z3A30-y!p~Mnz}9Kvt}9Tyk1A^sDtzISj@dBt-t7|loyTqgwlZ)!&wVsu+UXhxl?8M}i|}k#*a+o^OzcTRNFCzjxf;#oYeEBch{|5CHl3_Fv+HMfp1t#x-CxU@w!Go4J=GM*xz%sK^@H;{ zw+brvzvXpW{vxZ>GOw>VypOW4ehuIc+mDVW`cCh$qcZlW8n50k^hE?>Fcs+aVO%~8 z!_>#^*k7`nQVw{dFn=)@ySX&`C;bT{^5b>J?$$s#i5*R6c#z<8@UyD*HHt+djbHD%r zVkq|tH9i=vq^j?wFZLUbD^X_J&BP2HMoc&$f14?+`g7-`1#u0hRs_5?5nt(SQJEUH zaMA|8`{bJGPd&f;+1=mSGgDkKZT?mxIA(rd&6{ACQ!8_tS%?SU`k>$)^nzRB4jT#E}2#B6htE9RH^R+|61 zY?k~K5V_ALs_P6c=2G~f)7g`Nt4(4w7Jfg&* ziuXud-KtkHX6LnSU}a&?o5R}0zS>1-FAJp<7Z2DuaIo*tJ=jX4x{7%%8uPNcUd89<_uzL@Uy|(xx`!C^DS+&Oyo%RABAll0{daO9j11iTWx5E%N$(TU( zH?25;nUbm!%D|$3Mem7T*Ggvo{*vnWjCt6A9!<4&htRBr?ZV4!TLZjh-=g#|vd|9b zETUOE2kt*SFtmSQ_xvk+go5EUAH;GfwD}ehTT*`up%Ce0d#Dwu2uRGF7LK-P`CGW~ zf<T;MwZ{cUbJd}ebcKd9}V;;GJ$Ei-Bus+4qN9*YF+XxjCJXaT(1d3 z)yAR>FBnzhHRhLS$QFGz<`Hj<^6C@BBx4t%(?y4<<0rEDiep|igZ&A)=}kgNtB{jE z=2ow$4cK}BDyD+BE{5VbUq?Xfv$4a8Nuxy|O|GrE(x{>t@!m$8*|z3NwWt7*xd%<2 zpQDwXcTLxV$N74JE2-ALZ-%#J(1Ilg{J&On)!^&@E{+_7hTv`+1jSv3rI8q zl~&b8$`)OAW>`Nh&lVKNtOU?#UwO14qa%l~%?agfMW;qLemp$kXcL)dytp0Ee|+%LD{oD#x|R zS}bM+ezl4T!MRs{%t44A^shJpX?HSjnYh!-JJBTkYIhP+?d5zkOR%&^& zwNiaiQ9)T;f(pcMd6oLxu~GcaI*P8qoqxM_8=zRBXmu{a5vbn+px9#V zP3Xm!{U{^d$zCu_9Cm~Fb z`YTz0w0fD>s@2gEDOwye=UF=_ zHoG!r#Vz$di!W82x;0r1msd(){Q7mUV$3%MWI8r0;iC**Ylpxivwha26<{$9M4>U0}eBT@_*)@qZPnS*TLb)r4+j zvWCf8B++c`h7m!jk0|TrWr~RPBT6?j^YxM#UxpAqFec)uDZRYt?ZI%T?Cg{cyyD;$ zvAt9_^4!jIZYh;bI8`0oh#B|=nd;f^ZUY4*73>`kGe2(XRO!hI^kAyyt zw5aaF`J~d%Ov?rqzl(*QU~-(v%S>jO{0oz}nf!u@2=p^Y=o*s`nf#7P23uIozNJxqi?JN2Ixp;?^JNEM1~s_L5%{|kYW;NX*!tulm3;0rQ0nni~WXol)C zJ%t>O+E*VO?ms*@utvGT0tORaeB=}WxIB>MpG%A0mRuL4>4mm;!9HVMXB_X)Ns|5!3vPP>&Crr<4G19P9!8(v*G4io?oK#qSW=S$%GO% zN$$ER-Eh@p#)(~$*U1;96<1CA&F|u7JfrNAwEZo!`{$PC*`f-+C4bgz3!A+Gvv=~y zd2{*CEtS8tG|kVuXeqyBY4Tf|-nQglu;g5@Ioe){FJiKJf`6XMzOLm@LveR!Vof-~VcFtB*1B}~x%(7?Fd?M?s zS#gPQ>^7SOpXOcDo8a^OOKu9}ZS+f?xNWN}=T0t*OZ>eIP4X3MBNps{ zOe;)&snB111N7T4hitG6_jlbKY~Svey#BmaHq+*lGbeY3^Xks$)x{;8T<(%g&WVAL z?2DURa^qBWxVY_naoe1P6Hq56M2!G+x!fq_P)jwRFK*_1)Jp-nTxgV9CYMg^f8xH! z?wgYUYBd3hDRRENI+9fsGxK**z4)EAI_9i6pXe8w;k?@Od9`r~C-Loa zDYA})3);>XU^H+NUvrx**GzVXz18Qv)p3buSMN17$(@%aB=OJ6_sjCC$v-}64%e?f zU%xso@jQNyd4*gxWeyiM1_~SF5>Da|$cvEW4Hq>9ikjjQPU2hS7P(a)4}kH{$!&5A z%e0*@!t-$w@0Y9OlBtT5)#1i<=Ns3>C7i}LF>|`@RA;#Jw)360iOkEJWDLaVtYG_1 zoGloJo8H8Ed9Y*C!&&~EwxF~r?)J$mCpL3HR>oU5%JMdOqAM;5Aim4AUB)ED%;0Z) zpJ_;zGyVAuaf!g?eP(ItO8?58!OmTNslZ>fBq;5=>Rv22UzU)dAIjyt$$R1we&Rjy m4wGCr={-^YRZLUD@w+TL?Q-qpXX6roV}ovN(7&jLgZ#hMUwCW) literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_backends/__pycache__/_trio.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_backends/__pycache__/_trio.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2ca4fe405df21333f47a81e7e4b6c70aea45b2ef GIT binary patch literal 70334 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_backends/_asyncio.py b/.venv/Lib/site-packages/anyio/_backends/_asyncio.py new file mode 100644 index 0000000..ed91f40 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_backends/_asyncio.py @@ -0,0 +1,2816 @@ +from __future__ import annotations + +import array +import asyncio +import concurrent.futures +import contextvars +import math +import os +import socket +import sys +import threading +import weakref +from asyncio import ( + AbstractEventLoop, + CancelledError, + all_tasks, + create_task, + current_task, + get_running_loop, + sleep, +) +from asyncio.base_events import _run_until_complete_cb # type: ignore[attr-defined] +from collections import OrderedDict, deque +from collections.abc import ( + AsyncGenerator, + AsyncIterator, + Awaitable, + Callable, + Collection, + Coroutine, + Iterable, + Sequence, +) +from concurrent.futures import Future +from contextlib import AbstractContextManager, suppress +from contextvars import Context, copy_context +from dataclasses import dataclass +from functools import partial, wraps +from inspect import ( + CORO_RUNNING, + CORO_SUSPENDED, + getcoroutinestate, + iscoroutine, +) +from io import IOBase +from os import PathLike +from queue import Queue +from signal import Signals +from socket import AddressFamily, SocketKind +from threading import Thread +from types import CodeType, TracebackType +from typing import ( + IO, + TYPE_CHECKING, + Any, + Optional, + TypeVar, + cast, +) +from weakref import WeakKeyDictionary + +import sniffio + +from .. import ( + CapacityLimiterStatistics, + EventStatistics, + LockStatistics, + TaskInfo, + abc, +) +from .._core._eventloop import claim_worker_thread, threadlocals +from .._core._exceptions import ( + BrokenResourceError, + BusyResourceError, + ClosedResourceError, + EndOfStream, + WouldBlock, + iterate_exceptions, +) +from .._core._sockets import convert_ipv6_sockaddr +from .._core._streams import create_memory_object_stream +from .._core._synchronization import ( + CapacityLimiter as BaseCapacityLimiter, +) +from .._core._synchronization import Event as BaseEvent +from .._core._synchronization import Lock as BaseLock +from .._core._synchronization import ( + ResourceGuard, + SemaphoreStatistics, +) +from .._core._synchronization import Semaphore as BaseSemaphore +from .._core._tasks import CancelScope as BaseCancelScope +from ..abc import ( + AsyncBackend, + IPSockAddrType, + SocketListener, + UDPPacketType, + UNIXDatagramPacketType, +) +from ..abc._eventloop import StrOrBytesPath +from ..lowlevel import RunVar +from ..streams.memory import MemoryObjectReceiveStream, MemoryObjectSendStream + +if TYPE_CHECKING: + from _typeshed import FileDescriptorLike +else: + FileDescriptorLike = object + +if sys.version_info >= (3, 10): + from typing import ParamSpec +else: + from typing_extensions import ParamSpec + +if sys.version_info >= (3, 11): + from asyncio import Runner + from typing import TypeVarTuple, Unpack +else: + import contextvars + import enum + import signal + from asyncio import coroutines, events, exceptions, tasks + + from exceptiongroup import BaseExceptionGroup + from typing_extensions import TypeVarTuple, Unpack + + class _State(enum.Enum): + CREATED = "created" + INITIALIZED = "initialized" + CLOSED = "closed" + + class Runner: + # Copied from CPython 3.11 + def __init__( + self, + *, + debug: bool | None = None, + loop_factory: Callable[[], AbstractEventLoop] | None = None, + ): + self._state = _State.CREATED + self._debug = debug + self._loop_factory = loop_factory + self._loop: AbstractEventLoop | None = None + self._context = None + self._interrupt_count = 0 + self._set_event_loop = False + + def __enter__(self) -> Runner: + self._lazy_init() + return self + + def __exit__( + self, + exc_type: type[BaseException], + exc_val: BaseException, + exc_tb: TracebackType, + ) -> None: + self.close() + + def close(self) -> None: + """Shutdown and close event loop.""" + if self._state is not _State.INITIALIZED: + return + try: + loop = self._loop + _cancel_all_tasks(loop) + loop.run_until_complete(loop.shutdown_asyncgens()) + if hasattr(loop, "shutdown_default_executor"): + loop.run_until_complete(loop.shutdown_default_executor()) + else: + loop.run_until_complete(_shutdown_default_executor(loop)) + finally: + if self._set_event_loop: + events.set_event_loop(None) + loop.close() + self._loop = None + self._state = _State.CLOSED + + def get_loop(self) -> AbstractEventLoop: + """Return embedded event loop.""" + self._lazy_init() + return self._loop + + def run(self, coro: Coroutine[T_Retval], *, context=None) -> T_Retval: + """Run a coroutine inside the embedded event loop.""" + if not coroutines.iscoroutine(coro): + raise ValueError(f"a coroutine was expected, got {coro!r}") + + if events._get_running_loop() is not None: + # fail fast with short traceback + raise RuntimeError( + "Runner.run() cannot be called from a running event loop" + ) + + self._lazy_init() + + if context is None: + context = self._context + task = context.run(self._loop.create_task, coro) + + if ( + threading.current_thread() is threading.main_thread() + and signal.getsignal(signal.SIGINT) is signal.default_int_handler + ): + sigint_handler = partial(self._on_sigint, main_task=task) + try: + signal.signal(signal.SIGINT, sigint_handler) + except ValueError: + # `signal.signal` may throw if `threading.main_thread` does + # not support signals (e.g. embedded interpreter with signals + # not registered - see gh-91880) + sigint_handler = None + else: + sigint_handler = None + + self._interrupt_count = 0 + try: + return self._loop.run_until_complete(task) + except exceptions.CancelledError: + if self._interrupt_count > 0: + uncancel = getattr(task, "uncancel", None) + if uncancel is not None and uncancel() == 0: + raise KeyboardInterrupt() + raise # CancelledError + finally: + if ( + sigint_handler is not None + and signal.getsignal(signal.SIGINT) is sigint_handler + ): + signal.signal(signal.SIGINT, signal.default_int_handler) + + def _lazy_init(self) -> None: + if self._state is _State.CLOSED: + raise RuntimeError("Runner is closed") + if self._state is _State.INITIALIZED: + return + if self._loop_factory is None: + self._loop = events.new_event_loop() + if not self._set_event_loop: + # Call set_event_loop only once to avoid calling + # attach_loop multiple times on child watchers + events.set_event_loop(self._loop) + self._set_event_loop = True + else: + self._loop = self._loop_factory() + if self._debug is not None: + self._loop.set_debug(self._debug) + self._context = contextvars.copy_context() + self._state = _State.INITIALIZED + + def _on_sigint(self, signum, frame, main_task: asyncio.Task) -> None: + self._interrupt_count += 1 + if self._interrupt_count == 1 and not main_task.done(): + main_task.cancel() + # wakeup loop if it is blocked by select() with long timeout + self._loop.call_soon_threadsafe(lambda: None) + return + raise KeyboardInterrupt() + + def _cancel_all_tasks(loop: AbstractEventLoop) -> None: + to_cancel = tasks.all_tasks(loop) + if not to_cancel: + return + + for task in to_cancel: + task.cancel() + + loop.run_until_complete(tasks.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, + } + ) + + async def _shutdown_default_executor(loop: AbstractEventLoop) -> None: + """Schedule the shutdown of the default executor.""" + + def _do_shutdown(future: asyncio.futures.Future) -> None: + try: + loop._default_executor.shutdown(wait=True) # type: ignore[attr-defined] + loop.call_soon_threadsafe(future.set_result, None) + except Exception as ex: + loop.call_soon_threadsafe(future.set_exception, ex) + + loop._executor_shutdown_called = True + if loop._default_executor is None: + return + future = loop.create_future() + thread = threading.Thread(target=_do_shutdown, args=(future,)) + thread.start() + try: + await future + finally: + thread.join() + + +T_Retval = TypeVar("T_Retval") +T_contra = TypeVar("T_contra", contravariant=True) +PosArgsT = TypeVarTuple("PosArgsT") +P = ParamSpec("P") + +_root_task: RunVar[asyncio.Task | None] = RunVar("_root_task") + + +def find_root_task() -> asyncio.Task: + root_task = _root_task.get(None) + if root_task is not None and not root_task.done(): + return root_task + + # Look for a task that has been started via run_until_complete() + for task in all_tasks(): + if task._callbacks and not task.done(): + callbacks = [cb for cb, context in task._callbacks] + for cb in callbacks: + if ( + cb is _run_until_complete_cb + or getattr(cb, "__module__", None) == "uvloop.loop" + ): + _root_task.set(task) + return task + + # Look up the topmost task in the AnyIO task tree, if possible + task = cast(asyncio.Task, current_task()) + state = _task_states.get(task) + if state: + cancel_scope = state.cancel_scope + while cancel_scope and cancel_scope._parent_scope is not None: + cancel_scope = cancel_scope._parent_scope + + if cancel_scope is not None: + return cast(asyncio.Task, cancel_scope._host_task) + + return task + + +def get_callable_name(func: Callable) -> str: + module = getattr(func, "__module__", None) + qualname = getattr(func, "__qualname__", None) + return ".".join([x for x in (module, qualname) if x]) + + +# +# Event loop +# + +_run_vars: WeakKeyDictionary[asyncio.AbstractEventLoop, Any] = WeakKeyDictionary() + + +def _task_started(task: asyncio.Task) -> bool: + """Return ``True`` if the task has been started and has not finished.""" + # The task coro should never be None here, as we never add finished tasks to the + # task list + coro = task.get_coro() + assert coro is not None + try: + return getcoroutinestate(coro) in (CORO_RUNNING, CORO_SUSPENDED) + except AttributeError: + # task coro is async_genenerator_asend https://bugs.python.org/issue37771 + raise Exception(f"Cannot determine if task {task} has started or not") from None + + +# +# Timeouts and cancellation +# + + +def is_anyio_cancellation(exc: CancelledError) -> bool: + # Sometimes third party frameworks catch a CancelledError and raise a new one, so as + # a workaround we have to look at the previous ones in __context__ too for a + # matching cancel message + while True: + if ( + exc.args + and isinstance(exc.args[0], str) + and exc.args[0].startswith("Cancelled by cancel scope ") + ): + return True + + if isinstance(exc.__context__, CancelledError): + exc = exc.__context__ + continue + + return False + + +class CancelScope(BaseCancelScope): + def __new__( + cls, *, deadline: float = math.inf, shield: bool = False + ) -> CancelScope: + return object.__new__(cls) + + def __init__(self, deadline: float = math.inf, shield: bool = False): + self._deadline = deadline + self._shield = shield + self._parent_scope: CancelScope | None = None + self._child_scopes: set[CancelScope] = set() + self._cancel_called = False + self._cancelled_caught = False + self._active = False + self._timeout_handle: asyncio.TimerHandle | None = None + self._cancel_handle: asyncio.Handle | None = None + self._tasks: set[asyncio.Task] = set() + self._host_task: asyncio.Task | None = None + if sys.version_info >= (3, 11): + self._pending_uncancellations: int | None = 0 + else: + self._pending_uncancellations = None + + def __enter__(self) -> CancelScope: + if self._active: + raise RuntimeError( + "Each CancelScope may only be used for a single 'with' block" + ) + + self._host_task = host_task = cast(asyncio.Task, current_task()) + self._tasks.add(host_task) + try: + task_state = _task_states[host_task] + except KeyError: + task_state = TaskState(None, self) + _task_states[host_task] = task_state + else: + self._parent_scope = task_state.cancel_scope + task_state.cancel_scope = self + if self._parent_scope is not None: + # If using an eager task factory, the parent scope may not even contain + # the host task + self._parent_scope._child_scopes.add(self) + self._parent_scope._tasks.discard(host_task) + + self._timeout() + self._active = True + + # Start cancelling the host task if the scope was cancelled before entering + if self._cancel_called: + self._deliver_cancellation(self) + + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool: + del exc_tb + + if not self._active: + raise RuntimeError("This cancel scope is not active") + if current_task() is not self._host_task: + raise RuntimeError( + "Attempted to exit cancel scope in a different task than it was " + "entered in" + ) + + assert self._host_task is not None + host_task_state = _task_states.get(self._host_task) + if host_task_state is None or host_task_state.cancel_scope is not self: + raise RuntimeError( + "Attempted to exit a cancel scope that isn't the current tasks's " + "current cancel scope" + ) + + try: + self._active = False + if self._timeout_handle: + self._timeout_handle.cancel() + self._timeout_handle = None + + self._tasks.remove(self._host_task) + if self._parent_scope is not None: + self._parent_scope._child_scopes.remove(self) + self._parent_scope._tasks.add(self._host_task) + + host_task_state.cancel_scope = self._parent_scope + + # Restart the cancellation effort in the closest visible, cancelled parent + # scope if necessary + self._restart_cancellation_in_parent() + + # We only swallow the exception iff it was an AnyIO CancelledError, either + # directly as exc_val or inside an exception group and there are no cancelled + # parent cancel scopes visible to us here + if self._cancel_called and not self._parent_cancellation_is_visible_to_us: + # For each level-cancel() call made on the host task, call uncancel() + while self._pending_uncancellations: + self._host_task.uncancel() + self._pending_uncancellations -= 1 + + # Update cancelled_caught and check for exceptions we must not swallow + cannot_swallow_exc_val = False + if exc_val is not None: + for exc in iterate_exceptions(exc_val): + if isinstance(exc, CancelledError) and is_anyio_cancellation( + exc + ): + self._cancelled_caught = True + else: + cannot_swallow_exc_val = True + + return self._cancelled_caught and not cannot_swallow_exc_val + else: + if self._pending_uncancellations: + assert self._parent_scope is not None + assert self._parent_scope._pending_uncancellations is not None + self._parent_scope._pending_uncancellations += ( + self._pending_uncancellations + ) + self._pending_uncancellations = 0 + + return False + finally: + self._host_task = None + del exc_val + + @property + def _effectively_cancelled(self) -> bool: + cancel_scope: CancelScope | None = self + while cancel_scope is not None: + if cancel_scope._cancel_called: + return True + + if cancel_scope.shield: + return False + + cancel_scope = cancel_scope._parent_scope + + return False + + @property + def _parent_cancellation_is_visible_to_us(self) -> bool: + return ( + self._parent_scope is not None + and not self.shield + and self._parent_scope._effectively_cancelled + ) + + def _timeout(self) -> None: + if self._deadline != math.inf: + loop = get_running_loop() + if loop.time() >= self._deadline: + self.cancel() + else: + self._timeout_handle = loop.call_at(self._deadline, self._timeout) + + def _deliver_cancellation(self, origin: CancelScope) -> bool: + """ + Deliver cancellation to directly contained tasks and nested cancel scopes. + + Schedule another run at the end if we still have tasks eligible for + cancellation. + + :param origin: the cancel scope that originated the cancellation + :return: ``True`` if the delivery needs to be retried on the next cycle + + """ + should_retry = False + current = current_task() + for task in self._tasks: + should_retry = True + if task._must_cancel: # type: ignore[attr-defined] + continue + + # The task is eligible for cancellation if it has started + if task is not current and (task is self._host_task or _task_started(task)): + waiter = task._fut_waiter # type: ignore[attr-defined] + if not isinstance(waiter, asyncio.Future) or not waiter.done(): + task.cancel(f"Cancelled by cancel scope {id(origin):x}") + if ( + task is origin._host_task + and origin._pending_uncancellations is not None + ): + origin._pending_uncancellations += 1 + + # Deliver cancellation to child scopes that aren't shielded or running their own + # cancellation callbacks + for scope in self._child_scopes: + if not scope._shield and not scope.cancel_called: + should_retry = scope._deliver_cancellation(origin) or should_retry + + # Schedule another callback if there are still tasks left + if origin is self: + if should_retry: + self._cancel_handle = get_running_loop().call_soon( + self._deliver_cancellation, origin + ) + else: + self._cancel_handle = None + + return should_retry + + def _restart_cancellation_in_parent(self) -> None: + """ + Restart the cancellation effort in the closest directly cancelled parent scope. + + """ + scope = self._parent_scope + while scope is not None: + if scope._cancel_called: + if scope._cancel_handle is None: + scope._deliver_cancellation(scope) + + break + + # No point in looking beyond any shielded scope + if scope._shield: + break + + scope = scope._parent_scope + + def cancel(self) -> None: + if not self._cancel_called: + if self._timeout_handle: + self._timeout_handle.cancel() + self._timeout_handle = None + + self._cancel_called = True + if self._host_task is not None: + self._deliver_cancellation(self) + + @property + def deadline(self) -> float: + return self._deadline + + @deadline.setter + def deadline(self, value: float) -> None: + self._deadline = float(value) + if self._timeout_handle is not None: + self._timeout_handle.cancel() + self._timeout_handle = None + + if self._active and not self._cancel_called: + self._timeout() + + @property + def cancel_called(self) -> bool: + return self._cancel_called + + @property + def cancelled_caught(self) -> bool: + return self._cancelled_caught + + @property + def shield(self) -> bool: + return self._shield + + @shield.setter + def shield(self, value: bool) -> None: + if self._shield != value: + self._shield = value + if not value: + self._restart_cancellation_in_parent() + + +# +# Task states +# + + +class TaskState: + """ + Encapsulates auxiliary task information that cannot be added to the Task instance + itself because there are no guarantees about its implementation. + """ + + __slots__ = "parent_id", "cancel_scope", "__weakref__" + + def __init__(self, parent_id: int | None, cancel_scope: CancelScope | None): + self.parent_id = parent_id + self.cancel_scope = cancel_scope + + +_task_states: WeakKeyDictionary[asyncio.Task, TaskState] = WeakKeyDictionary() + + +# +# Task groups +# + + +class _AsyncioTaskStatus(abc.TaskStatus): + def __init__(self, future: asyncio.Future, parent_id: int): + self._future = future + self._parent_id = parent_id + + def started(self, value: T_contra | None = None) -> None: + try: + self._future.set_result(value) + except asyncio.InvalidStateError: + if not self._future.cancelled(): + raise RuntimeError( + "called 'started' twice on the same task status" + ) from None + + task = cast(asyncio.Task, current_task()) + _task_states[task].parent_id = self._parent_id + + +if sys.version_info >= (3, 12): + _eager_task_factory_code: CodeType | None = asyncio.eager_task_factory.__code__ +else: + _eager_task_factory_code = None + + +class TaskGroup(abc.TaskGroup): + def __init__(self) -> None: + self.cancel_scope: CancelScope = CancelScope() + self._active = False + self._exceptions: list[BaseException] = [] + self._tasks: set[asyncio.Task] = set() + self._on_completed_fut: asyncio.Future[None] | None = None + + async def __aenter__(self) -> TaskGroup: + self.cancel_scope.__enter__() + self._active = True + return self + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + try: + if exc_val is not None: + self.cancel_scope.cancel() + if not isinstance(exc_val, CancelledError): + self._exceptions.append(exc_val) + + loop = get_running_loop() + try: + if self._tasks: + with CancelScope() as wait_scope: + while self._tasks: + self._on_completed_fut = loop.create_future() + + try: + await self._on_completed_fut + except CancelledError as exc: + # Shield the scope against further cancellation attempts, + # as they're not productive (#695) + wait_scope.shield = True + self.cancel_scope.cancel() + + # Set exc_val from the cancellation exception if it was + # previously unset. However, we should not replace a native + # cancellation exception with one raise by a cancel scope. + if exc_val is None or ( + isinstance(exc_val, CancelledError) + and not is_anyio_cancellation(exc) + ): + exc_val = exc + + self._on_completed_fut = None + else: + # If there are no child tasks to wait on, run at least one checkpoint + # anyway + await AsyncIOBackend.cancel_shielded_checkpoint() + + self._active = False + if self._exceptions: + # The exception that got us here should already have been + # added to self._exceptions so it's ok to break exception + # chaining and avoid adding a "During handling of above..." + # for each nesting level. + raise BaseExceptionGroup( + "unhandled errors in a TaskGroup", self._exceptions + ) from None + elif exc_val: + raise exc_val + except BaseException as exc: + if self.cancel_scope.__exit__(type(exc), exc, exc.__traceback__): + return True + + raise + + return self.cancel_scope.__exit__(exc_type, exc_val, exc_tb) + finally: + del exc_val, exc_tb, self._exceptions + + def _spawn( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[Any]], + args: tuple[Unpack[PosArgsT]], + name: object, + task_status_future: asyncio.Future | None = None, + ) -> asyncio.Task: + def task_done(_task: asyncio.Task) -> None: + task_state = _task_states[_task] + assert task_state.cancel_scope is not None + assert _task in task_state.cancel_scope._tasks + task_state.cancel_scope._tasks.remove(_task) + self._tasks.remove(task) + del _task_states[_task] + + if self._on_completed_fut is not None and not self._tasks: + try: + self._on_completed_fut.set_result(None) + except asyncio.InvalidStateError: + pass + + try: + exc = _task.exception() + except CancelledError as e: + while isinstance(e.__context__, CancelledError): + e = e.__context__ + + exc = e + + if exc is not None: + # The future can only be in the cancelled state if the host task was + # cancelled, so return immediately instead of adding one more + # CancelledError to the exceptions list + if task_status_future is not None and task_status_future.cancelled(): + return + + if task_status_future is None or task_status_future.done(): + if not isinstance(exc, CancelledError): + self._exceptions.append(exc) + + if not self.cancel_scope._effectively_cancelled: + self.cancel_scope.cancel() + else: + task_status_future.set_exception(exc) + elif task_status_future is not None and not task_status_future.done(): + task_status_future.set_exception( + RuntimeError("Child exited without calling task_status.started()") + ) + + if not self._active: + raise RuntimeError( + "This task group is not active; no new tasks can be started." + ) + + kwargs = {} + if task_status_future: + parent_id = id(current_task()) + kwargs["task_status"] = _AsyncioTaskStatus( + task_status_future, id(self.cancel_scope._host_task) + ) + else: + parent_id = id(self.cancel_scope._host_task) + + coro = func(*args, **kwargs) + if not iscoroutine(coro): + prefix = f"{func.__module__}." if hasattr(func, "__module__") else "" + raise TypeError( + f"Expected {prefix}{func.__qualname__}() to return a coroutine, but " + f"the return value ({coro!r}) is not a coroutine object" + ) + + name = get_callable_name(func) if name is None else str(name) + loop = asyncio.get_running_loop() + if ( + (factory := loop.get_task_factory()) + and getattr(factory, "__code__", None) is _eager_task_factory_code + and (closure := getattr(factory, "__closure__", None)) + ): + custom_task_constructor = closure[0].cell_contents + task = custom_task_constructor(coro, loop=loop, name=name) + else: + task = create_task(coro, name=name) + + # Make the spawned task inherit the task group's cancel scope + _task_states[task] = TaskState( + parent_id=parent_id, cancel_scope=self.cancel_scope + ) + self.cancel_scope._tasks.add(task) + self._tasks.add(task) + task.add_done_callback(task_done) + return task + + def start_soon( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[Any]], + *args: Unpack[PosArgsT], + name: object = None, + ) -> None: + self._spawn(func, args, name) + + async def start( + self, func: Callable[..., Awaitable[Any]], *args: object, name: object = None + ) -> Any: + future: asyncio.Future = asyncio.Future() + task = self._spawn(func, args, name, future) + + # If the task raises an exception after sending a start value without a switch + # point between, the task group is cancelled and this method never proceeds to + # process the completed future. That's why we have to have a shielded cancel + # scope here. + try: + return await future + except CancelledError: + # Cancel the task and wait for it to exit before returning + task.cancel() + with CancelScope(shield=True), suppress(CancelledError): + await task + + raise + + +# +# Threads +# + +_Retval_Queue_Type = tuple[Optional[T_Retval], Optional[BaseException]] + + +class WorkerThread(Thread): + MAX_IDLE_TIME = 10 # seconds + + def __init__( + self, + root_task: asyncio.Task, + workers: set[WorkerThread], + idle_workers: deque[WorkerThread], + ): + super().__init__(name="AnyIO worker thread") + self.root_task = root_task + self.workers = workers + self.idle_workers = idle_workers + self.loop = root_task._loop + self.queue: Queue[ + tuple[Context, Callable, tuple, asyncio.Future, CancelScope] | None + ] = Queue(2) + self.idle_since = AsyncIOBackend.current_time() + self.stopping = False + + def _report_result( + self, future: asyncio.Future, result: Any, exc: BaseException | None + ) -> None: + self.idle_since = AsyncIOBackend.current_time() + if not self.stopping: + self.idle_workers.append(self) + + if not future.cancelled(): + if exc is not None: + if isinstance(exc, StopIteration): + new_exc = RuntimeError("coroutine raised StopIteration") + new_exc.__cause__ = exc + exc = new_exc + + future.set_exception(exc) + else: + future.set_result(result) + + def run(self) -> None: + with claim_worker_thread(AsyncIOBackend, self.loop): + while True: + item = self.queue.get() + if item is None: + # Shutdown command received + return + + context, func, args, future, cancel_scope = item + if not future.cancelled(): + result = None + exception: BaseException | None = None + threadlocals.current_cancel_scope = cancel_scope + try: + result = context.run(func, *args) + except BaseException as exc: + exception = exc + finally: + del threadlocals.current_cancel_scope + + if not self.loop.is_closed(): + self.loop.call_soon_threadsafe( + self._report_result, future, result, exception + ) + + del result, exception + + self.queue.task_done() + del item, context, func, args, future, cancel_scope + + def stop(self, f: asyncio.Task | None = None) -> None: + self.stopping = True + self.queue.put_nowait(None) + self.workers.discard(self) + try: + self.idle_workers.remove(self) + except ValueError: + pass + + +_threadpool_idle_workers: RunVar[deque[WorkerThread]] = RunVar( + "_threadpool_idle_workers" +) +_threadpool_workers: RunVar[set[WorkerThread]] = RunVar("_threadpool_workers") + + +class BlockingPortal(abc.BlockingPortal): + def __new__(cls) -> BlockingPortal: + return object.__new__(cls) + + def __init__(self) -> None: + super().__init__() + self._loop = get_running_loop() + + def _spawn_task_from_thread( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + name: object, + future: Future[T_Retval], + ) -> None: + AsyncIOBackend.run_sync_from_thread( + partial(self._task_group.start_soon, name=name), + (self._call_func, func, args, kwargs, future), + self._loop, + ) + + +# +# Subprocesses +# + + +@dataclass(eq=False) +class StreamReaderWrapper(abc.ByteReceiveStream): + _stream: asyncio.StreamReader + + async def receive(self, max_bytes: int = 65536) -> bytes: + data = await self._stream.read(max_bytes) + if data: + return data + else: + raise EndOfStream + + async def aclose(self) -> None: + self._stream.set_exception(ClosedResourceError()) + await AsyncIOBackend.checkpoint() + + +@dataclass(eq=False) +class StreamWriterWrapper(abc.ByteSendStream): + _stream: asyncio.StreamWriter + + async def send(self, item: bytes) -> None: + self._stream.write(item) + await self._stream.drain() + + async def aclose(self) -> None: + self._stream.close() + await AsyncIOBackend.checkpoint() + + +@dataclass(eq=False) +class Process(abc.Process): + _process: asyncio.subprocess.Process + _stdin: StreamWriterWrapper | None + _stdout: StreamReaderWrapper | None + _stderr: StreamReaderWrapper | None + + async def aclose(self) -> None: + with CancelScope(shield=True) as scope: + if self._stdin: + await self._stdin.aclose() + if self._stdout: + await self._stdout.aclose() + if self._stderr: + await self._stderr.aclose() + + scope.shield = False + try: + await self.wait() + except BaseException: + scope.shield = True + self.kill() + await self.wait() + raise + + async def wait(self) -> int: + return await self._process.wait() + + def terminate(self) -> None: + self._process.terminate() + + def kill(self) -> None: + self._process.kill() + + def send_signal(self, signal: int) -> None: + self._process.send_signal(signal) + + @property + def pid(self) -> int: + return self._process.pid + + @property + def returncode(self) -> int | None: + return self._process.returncode + + @property + def stdin(self) -> abc.ByteSendStream | None: + return self._stdin + + @property + def stdout(self) -> abc.ByteReceiveStream | None: + return self._stdout + + @property + def stderr(self) -> abc.ByteReceiveStream | None: + return self._stderr + + +def _forcibly_shutdown_process_pool_on_exit( + workers: set[Process], _task: object +) -> None: + """ + Forcibly shuts down worker processes belonging to this event loop.""" + child_watcher: asyncio.AbstractChildWatcher | None = None + if sys.version_info < (3, 12): + try: + child_watcher = asyncio.get_event_loop_policy().get_child_watcher() + except NotImplementedError: + pass + + # Close as much as possible (w/o async/await) to avoid warnings + for process in workers: + if process.returncode is None: + continue + + process._stdin._stream._transport.close() # type: ignore[union-attr] + process._stdout._stream._transport.close() # type: ignore[union-attr] + process._stderr._stream._transport.close() # type: ignore[union-attr] + process.kill() + if child_watcher: + child_watcher.remove_child_handler(process.pid) + + +async def _shutdown_process_pool_on_exit(workers: set[abc.Process]) -> None: + """ + Shuts down worker processes belonging to this event loop. + + NOTE: this only works when the event loop was started using asyncio.run() or + anyio.run(). + + """ + process: abc.Process + try: + await sleep(math.inf) + except asyncio.CancelledError: + for process in workers: + if process.returncode is None: + process.kill() + + for process in workers: + await process.aclose() + + +# +# Sockets and networking +# + + +class StreamProtocol(asyncio.Protocol): + read_queue: deque[bytes] + read_event: asyncio.Event + write_event: asyncio.Event + exception: Exception | None = None + is_at_eof: bool = False + + def connection_made(self, transport: asyncio.BaseTransport) -> None: + self.read_queue = deque() + self.read_event = asyncio.Event() + self.write_event = asyncio.Event() + self.write_event.set() + cast(asyncio.Transport, transport).set_write_buffer_limits(0) + + def connection_lost(self, exc: Exception | None) -> None: + if exc: + self.exception = BrokenResourceError() + self.exception.__cause__ = exc + + self.read_event.set() + self.write_event.set() + + def data_received(self, data: bytes) -> None: + # ProactorEventloop sometimes sends bytearray instead of bytes + self.read_queue.append(bytes(data)) + self.read_event.set() + + def eof_received(self) -> bool | None: + self.is_at_eof = True + self.read_event.set() + return True + + def pause_writing(self) -> None: + self.write_event = asyncio.Event() + + def resume_writing(self) -> None: + self.write_event.set() + + +class DatagramProtocol(asyncio.DatagramProtocol): + read_queue: deque[tuple[bytes, IPSockAddrType]] + read_event: asyncio.Event + write_event: asyncio.Event + exception: Exception | None = None + + def connection_made(self, transport: asyncio.BaseTransport) -> None: + self.read_queue = deque(maxlen=100) # arbitrary value + self.read_event = asyncio.Event() + self.write_event = asyncio.Event() + self.write_event.set() + + def connection_lost(self, exc: Exception | None) -> None: + self.read_event.set() + self.write_event.set() + + def datagram_received(self, data: bytes, addr: IPSockAddrType) -> None: + addr = convert_ipv6_sockaddr(addr) + self.read_queue.append((data, addr)) + self.read_event.set() + + def error_received(self, exc: Exception) -> None: + self.exception = exc + + def pause_writing(self) -> None: + self.write_event.clear() + + def resume_writing(self) -> None: + self.write_event.set() + + +class SocketStream(abc.SocketStream): + def __init__(self, transport: asyncio.Transport, protocol: StreamProtocol): + self._transport = transport + self._protocol = protocol + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + self._closed = False + + @property + def _raw_socket(self) -> socket.socket: + return self._transport.get_extra_info("socket") + + async def receive(self, max_bytes: int = 65536) -> bytes: + with self._receive_guard: + if ( + not self._protocol.read_event.is_set() + and not self._transport.is_closing() + and not self._protocol.is_at_eof + ): + self._transport.resume_reading() + await self._protocol.read_event.wait() + self._transport.pause_reading() + else: + await AsyncIOBackend.checkpoint() + + try: + chunk = self._protocol.read_queue.popleft() + except IndexError: + if self._closed: + raise ClosedResourceError from None + elif self._protocol.exception: + raise self._protocol.exception from None + else: + raise EndOfStream from None + + if len(chunk) > max_bytes: + # Split the oversized chunk + chunk, leftover = chunk[:max_bytes], chunk[max_bytes:] + self._protocol.read_queue.appendleft(leftover) + + # If the read queue is empty, clear the flag so that the next call will + # block until data is available + if not self._protocol.read_queue: + self._protocol.read_event.clear() + + return chunk + + async def send(self, item: bytes) -> None: + with self._send_guard: + await AsyncIOBackend.checkpoint() + + if self._closed: + raise ClosedResourceError + elif self._protocol.exception is not None: + raise self._protocol.exception + + try: + self._transport.write(item) + except RuntimeError as exc: + if self._transport.is_closing(): + raise BrokenResourceError from exc + else: + raise + + await self._protocol.write_event.wait() + + async def send_eof(self) -> None: + try: + self._transport.write_eof() + except OSError: + pass + + async def aclose(self) -> None: + if not self._transport.is_closing(): + self._closed = True + try: + self._transport.write_eof() + except OSError: + pass + + self._transport.close() + await sleep(0) + self._transport.abort() + + +class _RawSocketMixin: + _receive_future: asyncio.Future | None = None + _send_future: asyncio.Future | None = None + _closing = False + + def __init__(self, raw_socket: socket.socket): + self.__raw_socket = raw_socket + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + + @property + def _raw_socket(self) -> socket.socket: + return self.__raw_socket + + def _wait_until_readable(self, loop: asyncio.AbstractEventLoop) -> asyncio.Future: + def callback(f: object) -> None: + del self._receive_future + loop.remove_reader(self.__raw_socket) + + f = self._receive_future = asyncio.Future() + loop.add_reader(self.__raw_socket, f.set_result, None) + f.add_done_callback(callback) + return f + + def _wait_until_writable(self, loop: asyncio.AbstractEventLoop) -> asyncio.Future: + def callback(f: object) -> None: + del self._send_future + loop.remove_writer(self.__raw_socket) + + f = self._send_future = asyncio.Future() + loop.add_writer(self.__raw_socket, f.set_result, None) + f.add_done_callback(callback) + return f + + async def aclose(self) -> None: + if not self._closing: + self._closing = True + if self.__raw_socket.fileno() != -1: + self.__raw_socket.close() + + if self._receive_future: + self._receive_future.set_result(None) + if self._send_future: + self._send_future.set_result(None) + + +class UNIXSocketStream(_RawSocketMixin, abc.UNIXSocketStream): + async def send_eof(self) -> None: + with self._send_guard: + self._raw_socket.shutdown(socket.SHUT_WR) + + async def receive(self, max_bytes: int = 65536) -> bytes: + loop = get_running_loop() + await AsyncIOBackend.checkpoint() + with self._receive_guard: + while True: + try: + data = self._raw_socket.recv(max_bytes) + except BlockingIOError: + await self._wait_until_readable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + if not data: + raise EndOfStream + + return data + + async def send(self, item: bytes) -> None: + loop = get_running_loop() + await AsyncIOBackend.checkpoint() + with self._send_guard: + view = memoryview(item) + while view: + try: + bytes_sent = self._raw_socket.send(view) + except BlockingIOError: + await self._wait_until_writable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + view = view[bytes_sent:] + + async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]: + if not isinstance(msglen, int) or msglen < 0: + raise ValueError("msglen must be a non-negative integer") + if not isinstance(maxfds, int) or maxfds < 1: + raise ValueError("maxfds must be a positive integer") + + loop = get_running_loop() + fds = array.array("i") + await AsyncIOBackend.checkpoint() + with self._receive_guard: + while True: + try: + message, ancdata, flags, addr = self._raw_socket.recvmsg( + msglen, socket.CMSG_LEN(maxfds * fds.itemsize) + ) + except BlockingIOError: + await self._wait_until_readable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + if not message and not ancdata: + raise EndOfStream + + break + + for cmsg_level, cmsg_type, cmsg_data in ancdata: + if cmsg_level != socket.SOL_SOCKET or cmsg_type != socket.SCM_RIGHTS: + raise RuntimeError( + f"Received unexpected ancillary data; message = {message!r}, " + f"cmsg_level = {cmsg_level}, cmsg_type = {cmsg_type}" + ) + + fds.frombytes(cmsg_data[: len(cmsg_data) - (len(cmsg_data) % fds.itemsize)]) + + return message, list(fds) + + async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None: + if not message: + raise ValueError("message must not be empty") + if not fds: + raise ValueError("fds must not be empty") + + loop = get_running_loop() + filenos: list[int] = [] + for fd in fds: + if isinstance(fd, int): + filenos.append(fd) + elif isinstance(fd, IOBase): + filenos.append(fd.fileno()) + + fdarray = array.array("i", filenos) + await AsyncIOBackend.checkpoint() + with self._send_guard: + while True: + try: + # The ignore can be removed after mypy picks up + # https://github.com/python/typeshed/pull/5545 + self._raw_socket.sendmsg( + [message], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, fdarray)] + ) + break + except BlockingIOError: + await self._wait_until_writable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + + +class TCPSocketListener(abc.SocketListener): + _accept_scope: CancelScope | None = None + _closed = False + + def __init__(self, raw_socket: socket.socket): + self.__raw_socket = raw_socket + self._loop = cast(asyncio.BaseEventLoop, get_running_loop()) + self._accept_guard = ResourceGuard("accepting connections from") + + @property + def _raw_socket(self) -> socket.socket: + return self.__raw_socket + + async def accept(self) -> abc.SocketStream: + if self._closed: + raise ClosedResourceError + + with self._accept_guard: + await AsyncIOBackend.checkpoint() + with CancelScope() as self._accept_scope: + try: + client_sock, _addr = await self._loop.sock_accept(self._raw_socket) + except asyncio.CancelledError: + # Workaround for https://bugs.python.org/issue41317 + try: + self._loop.remove_reader(self._raw_socket) + except (ValueError, NotImplementedError): + pass + + if self._closed: + raise ClosedResourceError from None + + raise + finally: + self._accept_scope = None + + client_sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + transport, protocol = await self._loop.connect_accepted_socket( + StreamProtocol, client_sock + ) + return SocketStream(transport, protocol) + + async def aclose(self) -> None: + if self._closed: + return + + self._closed = True + if self._accept_scope: + # Workaround for https://bugs.python.org/issue41317 + try: + self._loop.remove_reader(self._raw_socket) + except (ValueError, NotImplementedError): + pass + + self._accept_scope.cancel() + await sleep(0) + + self._raw_socket.close() + + +class UNIXSocketListener(abc.SocketListener): + def __init__(self, raw_socket: socket.socket): + self.__raw_socket = raw_socket + self._loop = get_running_loop() + self._accept_guard = ResourceGuard("accepting connections from") + self._closed = False + + async def accept(self) -> abc.SocketStream: + await AsyncIOBackend.checkpoint() + with self._accept_guard: + while True: + try: + client_sock, _ = self.__raw_socket.accept() + client_sock.setblocking(False) + return UNIXSocketStream(client_sock) + except BlockingIOError: + f: asyncio.Future = asyncio.Future() + self._loop.add_reader(self.__raw_socket, f.set_result, None) + f.add_done_callback( + lambda _: self._loop.remove_reader(self.__raw_socket) + ) + await f + except OSError as exc: + if self._closed: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + + async def aclose(self) -> None: + self._closed = True + self.__raw_socket.close() + + @property + def _raw_socket(self) -> socket.socket: + return self.__raw_socket + + +class UDPSocket(abc.UDPSocket): + def __init__( + self, transport: asyncio.DatagramTransport, protocol: DatagramProtocol + ): + self._transport = transport + self._protocol = protocol + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + self._closed = False + + @property + def _raw_socket(self) -> socket.socket: + return self._transport.get_extra_info("socket") + + async def aclose(self) -> None: + if not self._transport.is_closing(): + self._closed = True + self._transport.close() + + async def receive(self) -> tuple[bytes, IPSockAddrType]: + with self._receive_guard: + await AsyncIOBackend.checkpoint() + + # If the buffer is empty, ask for more data + if not self._protocol.read_queue and not self._transport.is_closing(): + self._protocol.read_event.clear() + await self._protocol.read_event.wait() + + try: + return self._protocol.read_queue.popleft() + except IndexError: + if self._closed: + raise ClosedResourceError from None + else: + raise BrokenResourceError from None + + async def send(self, item: UDPPacketType) -> None: + with self._send_guard: + await AsyncIOBackend.checkpoint() + await self._protocol.write_event.wait() + if self._closed: + raise ClosedResourceError + elif self._transport.is_closing(): + raise BrokenResourceError + else: + self._transport.sendto(*item) + + +class ConnectedUDPSocket(abc.ConnectedUDPSocket): + def __init__( + self, transport: asyncio.DatagramTransport, protocol: DatagramProtocol + ): + self._transport = transport + self._protocol = protocol + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + self._closed = False + + @property + def _raw_socket(self) -> socket.socket: + return self._transport.get_extra_info("socket") + + async def aclose(self) -> None: + if not self._transport.is_closing(): + self._closed = True + self._transport.close() + + async def receive(self) -> bytes: + with self._receive_guard: + await AsyncIOBackend.checkpoint() + + # If the buffer is empty, ask for more data + if not self._protocol.read_queue and not self._transport.is_closing(): + self._protocol.read_event.clear() + await self._protocol.read_event.wait() + + try: + packet = self._protocol.read_queue.popleft() + except IndexError: + if self._closed: + raise ClosedResourceError from None + else: + raise BrokenResourceError from None + + return packet[0] + + async def send(self, item: bytes) -> None: + with self._send_guard: + await AsyncIOBackend.checkpoint() + await self._protocol.write_event.wait() + if self._closed: + raise ClosedResourceError + elif self._transport.is_closing(): + raise BrokenResourceError + else: + self._transport.sendto(item) + + +class UNIXDatagramSocket(_RawSocketMixin, abc.UNIXDatagramSocket): + async def receive(self) -> UNIXDatagramPacketType: + loop = get_running_loop() + await AsyncIOBackend.checkpoint() + with self._receive_guard: + while True: + try: + data = self._raw_socket.recvfrom(65536) + except BlockingIOError: + await self._wait_until_readable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + return data + + async def send(self, item: UNIXDatagramPacketType) -> None: + loop = get_running_loop() + await AsyncIOBackend.checkpoint() + with self._send_guard: + while True: + try: + self._raw_socket.sendto(*item) + except BlockingIOError: + await self._wait_until_writable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + return + + +class ConnectedUNIXDatagramSocket(_RawSocketMixin, abc.ConnectedUNIXDatagramSocket): + async def receive(self) -> bytes: + loop = get_running_loop() + await AsyncIOBackend.checkpoint() + with self._receive_guard: + while True: + try: + data = self._raw_socket.recv(65536) + except BlockingIOError: + await self._wait_until_readable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + return data + + async def send(self, item: bytes) -> None: + loop = get_running_loop() + await AsyncIOBackend.checkpoint() + with self._send_guard: + while True: + try: + self._raw_socket.send(item) + except BlockingIOError: + await self._wait_until_writable(loop) + except OSError as exc: + if self._closing: + raise ClosedResourceError from None + else: + raise BrokenResourceError from exc + else: + return + + +_read_events: RunVar[dict[int, asyncio.Event]] = RunVar("read_events") +_write_events: RunVar[dict[int, asyncio.Event]] = RunVar("write_events") + + +# +# Synchronization +# + + +class Event(BaseEvent): + def __new__(cls) -> Event: + return object.__new__(cls) + + def __init__(self) -> None: + self._event = asyncio.Event() + + def set(self) -> None: + self._event.set() + + def is_set(self) -> bool: + return self._event.is_set() + + async def wait(self) -> None: + if self.is_set(): + await AsyncIOBackend.checkpoint() + else: + await self._event.wait() + + def statistics(self) -> EventStatistics: + return EventStatistics(len(self._event._waiters)) + + +class Lock(BaseLock): + def __new__(cls, *, fast_acquire: bool = False) -> Lock: + return object.__new__(cls) + + def __init__(self, *, fast_acquire: bool = False) -> None: + self._fast_acquire = fast_acquire + self._owner_task: asyncio.Task | None = None + self._waiters: deque[tuple[asyncio.Task, asyncio.Future]] = deque() + + async def acquire(self) -> None: + task = cast(asyncio.Task, current_task()) + if self._owner_task is None and not self._waiters: + await AsyncIOBackend.checkpoint_if_cancelled() + self._owner_task = task + + # Unless on the "fast path", yield control of the event loop so that other + # tasks can run too + if not self._fast_acquire: + try: + await AsyncIOBackend.cancel_shielded_checkpoint() + except CancelledError: + self.release() + raise + + return + + if self._owner_task == task: + raise RuntimeError("Attempted to acquire an already held Lock") + + fut: asyncio.Future[None] = asyncio.Future() + item = task, fut + self._waiters.append(item) + try: + await fut + except CancelledError: + self._waiters.remove(item) + if self._owner_task is task: + self.release() + + raise + + self._waiters.remove(item) + + def acquire_nowait(self) -> None: + task = cast(asyncio.Task, current_task()) + if self._owner_task is None and not self._waiters: + self._owner_task = task + return + + if self._owner_task is task: + raise RuntimeError("Attempted to acquire an already held Lock") + + raise WouldBlock + + def locked(self) -> bool: + return self._owner_task is not None + + def release(self) -> None: + if self._owner_task != current_task(): + raise RuntimeError("The current task is not holding this lock") + + for task, fut in self._waiters: + if not fut.cancelled(): + self._owner_task = task + fut.set_result(None) + return + + self._owner_task = None + + def statistics(self) -> LockStatistics: + task_info = AsyncIOTaskInfo(self._owner_task) if self._owner_task else None + return LockStatistics(self.locked(), task_info, len(self._waiters)) + + +class Semaphore(BaseSemaphore): + def __new__( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> Semaphore: + return object.__new__(cls) + + def __init__( + self, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ): + super().__init__(initial_value, max_value=max_value) + self._value = initial_value + self._max_value = max_value + self._fast_acquire = fast_acquire + self._waiters: deque[asyncio.Future[None]] = deque() + + async def acquire(self) -> None: + if self._value > 0 and not self._waiters: + await AsyncIOBackend.checkpoint_if_cancelled() + self._value -= 1 + + # Unless on the "fast path", yield control of the event loop so that other + # tasks can run too + if not self._fast_acquire: + try: + await AsyncIOBackend.cancel_shielded_checkpoint() + except CancelledError: + self.release() + raise + + return + + fut: asyncio.Future[None] = asyncio.Future() + self._waiters.append(fut) + try: + await fut + except CancelledError: + try: + self._waiters.remove(fut) + except ValueError: + self.release() + + raise + + def acquire_nowait(self) -> None: + if self._value == 0: + raise WouldBlock + + self._value -= 1 + + def release(self) -> None: + if self._max_value is not None and self._value == self._max_value: + raise ValueError("semaphore released too many times") + + for fut in self._waiters: + if not fut.cancelled(): + fut.set_result(None) + self._waiters.remove(fut) + return + + self._value += 1 + + @property + def value(self) -> int: + return self._value + + @property + def max_value(self) -> int | None: + return self._max_value + + def statistics(self) -> SemaphoreStatistics: + return SemaphoreStatistics(len(self._waiters)) + + +class CapacityLimiter(BaseCapacityLimiter): + _total_tokens: float = 0 + + def __new__(cls, total_tokens: float) -> CapacityLimiter: + return object.__new__(cls) + + def __init__(self, total_tokens: float): + self._borrowers: set[Any] = set() + self._wait_queue: OrderedDict[Any, asyncio.Event] = OrderedDict() + self.total_tokens = total_tokens + + async def __aenter__(self) -> None: + await self.acquire() + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self.release() + + @property + def total_tokens(self) -> float: + return self._total_tokens + + @total_tokens.setter + def total_tokens(self, value: float) -> None: + if not isinstance(value, int) and not math.isinf(value): + raise TypeError("total_tokens must be an int or math.inf") + if value < 1: + raise ValueError("total_tokens must be >= 1") + + waiters_to_notify = max(value - self._total_tokens, 0) + self._total_tokens = value + + # Notify waiting tasks that they have acquired the limiter + while self._wait_queue and waiters_to_notify: + event = self._wait_queue.popitem(last=False)[1] + event.set() + waiters_to_notify -= 1 + + @property + def borrowed_tokens(self) -> int: + return len(self._borrowers) + + @property + def available_tokens(self) -> float: + return self._total_tokens - len(self._borrowers) + + def acquire_nowait(self) -> None: + self.acquire_on_behalf_of_nowait(current_task()) + + def acquire_on_behalf_of_nowait(self, borrower: object) -> None: + if borrower in self._borrowers: + raise RuntimeError( + "this borrower is already holding one of this CapacityLimiter's tokens" + ) + + if self._wait_queue or len(self._borrowers) >= self._total_tokens: + raise WouldBlock + + self._borrowers.add(borrower) + + async def acquire(self) -> None: + return await self.acquire_on_behalf_of(current_task()) + + async def acquire_on_behalf_of(self, borrower: object) -> None: + await AsyncIOBackend.checkpoint_if_cancelled() + try: + self.acquire_on_behalf_of_nowait(borrower) + except WouldBlock: + event = asyncio.Event() + self._wait_queue[borrower] = event + try: + await event.wait() + except BaseException: + self._wait_queue.pop(borrower, None) + raise + + self._borrowers.add(borrower) + else: + try: + await AsyncIOBackend.cancel_shielded_checkpoint() + except BaseException: + self.release() + raise + + def release(self) -> None: + self.release_on_behalf_of(current_task()) + + def release_on_behalf_of(self, borrower: object) -> None: + try: + self._borrowers.remove(borrower) + except KeyError: + raise RuntimeError( + "this borrower isn't holding any of this CapacityLimiter's tokens" + ) from None + + # Notify the next task in line if this limiter has free capacity now + if self._wait_queue and len(self._borrowers) < self._total_tokens: + event = self._wait_queue.popitem(last=False)[1] + event.set() + + def statistics(self) -> CapacityLimiterStatistics: + return CapacityLimiterStatistics( + self.borrowed_tokens, + self.total_tokens, + tuple(self._borrowers), + len(self._wait_queue), + ) + + +_default_thread_limiter: RunVar[CapacityLimiter] = RunVar("_default_thread_limiter") + + +# +# Operating system signals +# + + +class _SignalReceiver: + def __init__(self, signals: tuple[Signals, ...]): + self._signals = signals + self._loop = get_running_loop() + self._signal_queue: deque[Signals] = deque() + self._future: asyncio.Future = asyncio.Future() + self._handled_signals: set[Signals] = set() + + def _deliver(self, signum: Signals) -> None: + self._signal_queue.append(signum) + if not self._future.done(): + self._future.set_result(None) + + def __enter__(self) -> _SignalReceiver: + for sig in set(self._signals): + self._loop.add_signal_handler(sig, self._deliver, sig) + self._handled_signals.add(sig) + + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + for sig in self._handled_signals: + self._loop.remove_signal_handler(sig) + + def __aiter__(self) -> _SignalReceiver: + return self + + async def __anext__(self) -> Signals: + await AsyncIOBackend.checkpoint() + if not self._signal_queue: + self._future = asyncio.Future() + await self._future + + return self._signal_queue.popleft() + + +# +# Testing and debugging +# + + +class AsyncIOTaskInfo(TaskInfo): + def __init__(self, task: asyncio.Task): + task_state = _task_states.get(task) + if task_state is None: + parent_id = None + else: + parent_id = task_state.parent_id + + coro = task.get_coro() + assert coro is not None, "created TaskInfo from a completed Task" + super().__init__(id(task), parent_id, task.get_name(), coro) + self._task = weakref.ref(task) + + def has_pending_cancellation(self) -> bool: + if not (task := self._task()): + # If the task isn't around anymore, it won't have a pending cancellation + return False + + if task._must_cancel: # type: ignore[attr-defined] + return True + elif ( + isinstance(task._fut_waiter, asyncio.Future) # type: ignore[attr-defined] + and task._fut_waiter.cancelled() # type: ignore[attr-defined] + ): + return True + + if task_state := _task_states.get(task): + if cancel_scope := task_state.cancel_scope: + return cancel_scope._effectively_cancelled + + return False + + +class TestRunner(abc.TestRunner): + _send_stream: MemoryObjectSendStream[tuple[Awaitable[Any], asyncio.Future[Any]]] + + def __init__( + self, + *, + debug: bool | None = None, + use_uvloop: bool = False, + loop_factory: Callable[[], AbstractEventLoop] | None = None, + ) -> None: + if use_uvloop and loop_factory is None: + import uvloop + + loop_factory = uvloop.new_event_loop + + self._runner = Runner(debug=debug, loop_factory=loop_factory) + self._exceptions: list[BaseException] = [] + self._runner_task: asyncio.Task | None = None + + def __enter__(self) -> TestRunner: + self._runner.__enter__() + self.get_loop().set_exception_handler(self._exception_handler) + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self._runner.__exit__(exc_type, exc_val, exc_tb) + + def get_loop(self) -> AbstractEventLoop: + return self._runner.get_loop() + + def _exception_handler( + self, loop: asyncio.AbstractEventLoop, context: dict[str, Any] + ) -> None: + if isinstance(context.get("exception"), Exception): + self._exceptions.append(context["exception"]) + else: + loop.default_exception_handler(context) + + def _raise_async_exceptions(self) -> None: + # Re-raise any exceptions raised in asynchronous callbacks + if self._exceptions: + exceptions, self._exceptions = self._exceptions, [] + if len(exceptions) == 1: + raise exceptions[0] + elif exceptions: + raise BaseExceptionGroup( + "Multiple exceptions occurred in asynchronous callbacks", exceptions + ) + + async def _run_tests_and_fixtures( + self, + receive_stream: MemoryObjectReceiveStream[ + tuple[Awaitable[T_Retval], asyncio.Future[T_Retval]] + ], + ) -> None: + from _pytest.outcomes import OutcomeException + + with receive_stream, self._send_stream: + async for coro, future in receive_stream: + try: + retval = await coro + except CancelledError as exc: + if not future.cancelled(): + future.cancel(*exc.args) + + raise + except BaseException as exc: + if not future.cancelled(): + future.set_exception(exc) + + if not isinstance(exc, (Exception, OutcomeException)): + raise + else: + if not future.cancelled(): + future.set_result(retval) + + async def _call_in_runner_task( + self, + func: Callable[P, Awaitable[T_Retval]], + *args: P.args, + **kwargs: P.kwargs, + ) -> T_Retval: + if not self._runner_task: + self._send_stream, receive_stream = create_memory_object_stream[ + tuple[Awaitable[Any], asyncio.Future] + ](1) + self._runner_task = self.get_loop().create_task( + self._run_tests_and_fixtures(receive_stream) + ) + + coro = func(*args, **kwargs) + future: asyncio.Future[T_Retval] = self.get_loop().create_future() + self._send_stream.send_nowait((coro, future)) + return await future + + def run_asyncgen_fixture( + self, + fixture_func: Callable[..., AsyncGenerator[T_Retval, Any]], + kwargs: dict[str, Any], + ) -> Iterable[T_Retval]: + asyncgen = fixture_func(**kwargs) + fixturevalue: T_Retval = self.get_loop().run_until_complete( + self._call_in_runner_task(asyncgen.asend, None) + ) + self._raise_async_exceptions() + + yield fixturevalue + + try: + self.get_loop().run_until_complete( + self._call_in_runner_task(asyncgen.asend, None) + ) + except StopAsyncIteration: + self._raise_async_exceptions() + else: + self.get_loop().run_until_complete(asyncgen.aclose()) + raise RuntimeError("Async generator fixture did not stop") + + def run_fixture( + self, + fixture_func: Callable[..., Coroutine[Any, Any, T_Retval]], + kwargs: dict[str, Any], + ) -> T_Retval: + retval = self.get_loop().run_until_complete( + self._call_in_runner_task(fixture_func, **kwargs) + ) + self._raise_async_exceptions() + return retval + + def run_test( + self, test_func: Callable[..., Coroutine[Any, Any, Any]], kwargs: dict[str, Any] + ) -> None: + try: + self.get_loop().run_until_complete( + self._call_in_runner_task(test_func, **kwargs) + ) + except Exception as exc: + self._exceptions.append(exc) + + self._raise_async_exceptions() + + +class AsyncIOBackend(AsyncBackend): + @classmethod + def run( + cls, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + options: dict[str, Any], + ) -> T_Retval: + @wraps(func) + async def wrapper() -> T_Retval: + task = cast(asyncio.Task, current_task()) + task.set_name(get_callable_name(func)) + _task_states[task] = TaskState(None, None) + + try: + return await func(*args) + finally: + del _task_states[task] + + debug = options.get("debug", None) + loop_factory = options.get("loop_factory", None) + if loop_factory is None and options.get("use_uvloop", False): + import uvloop + + loop_factory = uvloop.new_event_loop + + with Runner(debug=debug, loop_factory=loop_factory) as runner: + return runner.run(wrapper()) + + @classmethod + def current_token(cls) -> object: + return get_running_loop() + + @classmethod + def current_time(cls) -> float: + return get_running_loop().time() + + @classmethod + def cancelled_exception_class(cls) -> type[BaseException]: + return CancelledError + + @classmethod + async def checkpoint(cls) -> None: + await sleep(0) + + @classmethod + async def checkpoint_if_cancelled(cls) -> None: + task = current_task() + if task is None: + return + + try: + cancel_scope = _task_states[task].cancel_scope + except KeyError: + return + + while cancel_scope: + if cancel_scope.cancel_called: + await sleep(0) + elif cancel_scope.shield: + break + else: + cancel_scope = cancel_scope._parent_scope + + @classmethod + async def cancel_shielded_checkpoint(cls) -> None: + with CancelScope(shield=True): + await sleep(0) + + @classmethod + async def sleep(cls, delay: float) -> None: + await sleep(delay) + + @classmethod + def create_cancel_scope( + cls, *, deadline: float = math.inf, shield: bool = False + ) -> CancelScope: + return CancelScope(deadline=deadline, shield=shield) + + @classmethod + def current_effective_deadline(cls) -> float: + if (task := current_task()) is None: + return math.inf + + try: + cancel_scope = _task_states[task].cancel_scope + except KeyError: + return math.inf + + deadline = math.inf + while cancel_scope: + deadline = min(deadline, cancel_scope.deadline) + if cancel_scope._cancel_called: + deadline = -math.inf + break + elif cancel_scope.shield: + break + else: + cancel_scope = cancel_scope._parent_scope + + return deadline + + @classmethod + def create_task_group(cls) -> abc.TaskGroup: + return TaskGroup() + + @classmethod + def create_event(cls) -> abc.Event: + return Event() + + @classmethod + def create_lock(cls, *, fast_acquire: bool) -> abc.Lock: + return Lock(fast_acquire=fast_acquire) + + @classmethod + def create_semaphore( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> abc.Semaphore: + return Semaphore(initial_value, max_value=max_value, fast_acquire=fast_acquire) + + @classmethod + def create_capacity_limiter(cls, total_tokens: float) -> abc.CapacityLimiter: + return CapacityLimiter(total_tokens) + + @classmethod + async def run_sync_in_worker_thread( # type: ignore[return] + cls, + func: Callable[[Unpack[PosArgsT]], T_Retval], + args: tuple[Unpack[PosArgsT]], + abandon_on_cancel: bool = False, + limiter: abc.CapacityLimiter | None = None, + ) -> T_Retval: + await cls.checkpoint() + + # If this is the first run in this event loop thread, set up the necessary + # variables + try: + idle_workers = _threadpool_idle_workers.get() + workers = _threadpool_workers.get() + except LookupError: + idle_workers = deque() + workers = set() + _threadpool_idle_workers.set(idle_workers) + _threadpool_workers.set(workers) + + async with limiter or cls.current_default_thread_limiter(): + with CancelScope(shield=not abandon_on_cancel) as scope: + future = asyncio.Future[T_Retval]() + root_task = find_root_task() + if not idle_workers: + worker = WorkerThread(root_task, workers, idle_workers) + worker.start() + workers.add(worker) + root_task.add_done_callback( + worker.stop, context=contextvars.Context() + ) + else: + worker = idle_workers.pop() + + # Prune any other workers that have been idle for MAX_IDLE_TIME + # seconds or longer + now = cls.current_time() + while idle_workers: + if ( + now - idle_workers[0].idle_since + < WorkerThread.MAX_IDLE_TIME + ): + break + + expired_worker = idle_workers.popleft() + expired_worker.root_task.remove_done_callback( + expired_worker.stop + ) + expired_worker.stop() + + context = copy_context() + context.run(sniffio.current_async_library_cvar.set, None) + if abandon_on_cancel or scope._parent_scope is None: + worker_scope = scope + else: + worker_scope = scope._parent_scope + + worker.queue.put_nowait((context, func, args, future, worker_scope)) + return await future + + @classmethod + def check_cancelled(cls) -> None: + scope: CancelScope | None = threadlocals.current_cancel_scope + while scope is not None: + if scope.cancel_called: + raise CancelledError(f"Cancelled by cancel scope {id(scope):x}") + + if scope.shield: + return + + scope = scope._parent_scope + + @classmethod + def run_async_from_thread( + cls, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + args: tuple[Unpack[PosArgsT]], + token: object, + ) -> T_Retval: + async def task_wrapper(scope: CancelScope) -> T_Retval: + __tracebackhide__ = True + task = cast(asyncio.Task, current_task()) + _task_states[task] = TaskState(None, scope) + scope._tasks.add(task) + try: + return await func(*args) + except CancelledError as exc: + raise concurrent.futures.CancelledError(str(exc)) from None + finally: + scope._tasks.discard(task) + + loop = cast(AbstractEventLoop, token) + context = copy_context() + context.run(sniffio.current_async_library_cvar.set, "asyncio") + wrapper = task_wrapper(threadlocals.current_cancel_scope) + f: concurrent.futures.Future[T_Retval] = context.run( + asyncio.run_coroutine_threadsafe, wrapper, loop + ) + return f.result() + + @classmethod + def run_sync_from_thread( + cls, + func: Callable[[Unpack[PosArgsT]], T_Retval], + args: tuple[Unpack[PosArgsT]], + token: object, + ) -> T_Retval: + @wraps(func) + def wrapper() -> None: + try: + sniffio.current_async_library_cvar.set("asyncio") + f.set_result(func(*args)) + except BaseException as exc: + f.set_exception(exc) + if not isinstance(exc, Exception): + raise + + f: concurrent.futures.Future[T_Retval] = Future() + loop = cast(AbstractEventLoop, token) + loop.call_soon_threadsafe(wrapper) + return f.result() + + @classmethod + def create_blocking_portal(cls) -> abc.BlockingPortal: + return BlockingPortal() + + @classmethod + async def open_process( + cls, + command: StrOrBytesPath | Sequence[StrOrBytesPath], + *, + stdin: int | IO[Any] | None, + stdout: int | IO[Any] | None, + stderr: int | IO[Any] | None, + **kwargs: Any, + ) -> Process: + await cls.checkpoint() + if isinstance(command, PathLike): + command = os.fspath(command) + + if isinstance(command, (str, bytes)): + process = await asyncio.create_subprocess_shell( + command, + stdin=stdin, + stdout=stdout, + stderr=stderr, + **kwargs, + ) + else: + process = await asyncio.create_subprocess_exec( + *command, + stdin=stdin, + stdout=stdout, + stderr=stderr, + **kwargs, + ) + + stdin_stream = StreamWriterWrapper(process.stdin) if process.stdin else None + stdout_stream = StreamReaderWrapper(process.stdout) if process.stdout else None + stderr_stream = StreamReaderWrapper(process.stderr) if process.stderr else None + return Process(process, stdin_stream, stdout_stream, stderr_stream) + + @classmethod + def setup_process_pool_exit_at_shutdown(cls, workers: set[abc.Process]) -> None: + create_task( + _shutdown_process_pool_on_exit(workers), + name="AnyIO process pool shutdown task", + ) + find_root_task().add_done_callback( + partial(_forcibly_shutdown_process_pool_on_exit, workers) # type:ignore[arg-type] + ) + + @classmethod + async def connect_tcp( + cls, host: str, port: int, local_address: IPSockAddrType | None = None + ) -> abc.SocketStream: + transport, protocol = cast( + tuple[asyncio.Transport, StreamProtocol], + await get_running_loop().create_connection( + StreamProtocol, host, port, local_addr=local_address + ), + ) + transport.pause_reading() + return SocketStream(transport, protocol) + + @classmethod + async def connect_unix(cls, path: str | bytes) -> abc.UNIXSocketStream: + await cls.checkpoint() + loop = get_running_loop() + raw_socket = socket.socket(socket.AF_UNIX) + raw_socket.setblocking(False) + while True: + try: + raw_socket.connect(path) + except BlockingIOError: + f: asyncio.Future = asyncio.Future() + loop.add_writer(raw_socket, f.set_result, None) + f.add_done_callback(lambda _: loop.remove_writer(raw_socket)) + await f + except BaseException: + raw_socket.close() + raise + else: + return UNIXSocketStream(raw_socket) + + @classmethod + def create_tcp_listener(cls, sock: socket.socket) -> SocketListener: + return TCPSocketListener(sock) + + @classmethod + def create_unix_listener(cls, sock: socket.socket) -> SocketListener: + return UNIXSocketListener(sock) + + @classmethod + async def create_udp_socket( + cls, + family: AddressFamily, + local_address: IPSockAddrType | None, + remote_address: IPSockAddrType | None, + reuse_port: bool, + ) -> UDPSocket | ConnectedUDPSocket: + transport, protocol = await get_running_loop().create_datagram_endpoint( + DatagramProtocol, + local_addr=local_address, + remote_addr=remote_address, + family=family, + reuse_port=reuse_port, + ) + if protocol.exception: + transport.close() + raise protocol.exception + + if not remote_address: + return UDPSocket(transport, protocol) + else: + return ConnectedUDPSocket(transport, protocol) + + @classmethod + async def create_unix_datagram_socket( # type: ignore[override] + cls, raw_socket: socket.socket, remote_path: str | bytes | None + ) -> abc.UNIXDatagramSocket | abc.ConnectedUNIXDatagramSocket: + await cls.checkpoint() + loop = get_running_loop() + + if remote_path: + while True: + try: + raw_socket.connect(remote_path) + except BlockingIOError: + f: asyncio.Future = asyncio.Future() + loop.add_writer(raw_socket, f.set_result, None) + f.add_done_callback(lambda _: loop.remove_writer(raw_socket)) + await f + except BaseException: + raw_socket.close() + raise + else: + return ConnectedUNIXDatagramSocket(raw_socket) + else: + return UNIXDatagramSocket(raw_socket) + + @classmethod + async def getaddrinfo( + cls, + host: bytes | str | None, + port: str | int | None, + *, + family: int | AddressFamily = 0, + type: int | SocketKind = 0, + proto: int = 0, + flags: int = 0, + ) -> Sequence[ + tuple[ + AddressFamily, + SocketKind, + int, + str, + tuple[str, int] | tuple[str, int, int, int] | tuple[int, bytes], + ] + ]: + return await get_running_loop().getaddrinfo( + host, port, family=family, type=type, proto=proto, flags=flags + ) + + @classmethod + async def getnameinfo( + cls, sockaddr: IPSockAddrType, flags: int = 0 + ) -> tuple[str, str]: + return await get_running_loop().getnameinfo(sockaddr, flags) + + @classmethod + async def wait_readable(cls, obj: FileDescriptorLike) -> None: + await cls.checkpoint() + try: + read_events = _read_events.get() + except LookupError: + read_events = {} + _read_events.set(read_events) + + if not isinstance(obj, int): + obj = obj.fileno() + + if read_events.get(obj): + raise BusyResourceError("reading from") + + loop = get_running_loop() + event = asyncio.Event() + try: + loop.add_reader(obj, event.set) + except NotImplementedError: + from anyio._core._asyncio_selector_thread import get_selector + + selector = get_selector() + selector.add_reader(obj, event.set) + remove_reader = selector.remove_reader + else: + remove_reader = loop.remove_reader + + read_events[obj] = event + try: + await event.wait() + finally: + remove_reader(obj) + del read_events[obj] + + @classmethod + async def wait_writable(cls, obj: FileDescriptorLike) -> None: + await cls.checkpoint() + try: + write_events = _write_events.get() + except LookupError: + write_events = {} + _write_events.set(write_events) + + if not isinstance(obj, int): + obj = obj.fileno() + + if write_events.get(obj): + raise BusyResourceError("writing to") + + loop = get_running_loop() + event = asyncio.Event() + try: + loop.add_writer(obj, event.set) + except NotImplementedError: + from anyio._core._asyncio_selector_thread import get_selector + + selector = get_selector() + selector.add_writer(obj, event.set) + remove_writer = selector.remove_writer + else: + remove_writer = loop.remove_writer + + write_events[obj] = event + try: + await event.wait() + finally: + del write_events[obj] + remove_writer(obj) + + @classmethod + def current_default_thread_limiter(cls) -> CapacityLimiter: + try: + return _default_thread_limiter.get() + except LookupError: + limiter = CapacityLimiter(40) + _default_thread_limiter.set(limiter) + return limiter + + @classmethod + def open_signal_receiver( + cls, *signals: Signals + ) -> AbstractContextManager[AsyncIterator[Signals]]: + return _SignalReceiver(signals) + + @classmethod + def get_current_task(cls) -> TaskInfo: + return AsyncIOTaskInfo(current_task()) # type: ignore[arg-type] + + @classmethod + def get_running_tasks(cls) -> Sequence[TaskInfo]: + return [AsyncIOTaskInfo(task) for task in all_tasks() if not task.done()] + + @classmethod + async def wait_all_tasks_blocked(cls) -> None: + await cls.checkpoint() + this_task = current_task() + while True: + for task in all_tasks(): + if task is this_task: + continue + + waiter = task._fut_waiter # type: ignore[attr-defined] + if waiter is None or waiter.done(): + await sleep(0.1) + break + else: + return + + @classmethod + def create_test_runner(cls, options: dict[str, Any]) -> TestRunner: + return TestRunner(**options) + + +backend_class = AsyncIOBackend diff --git a/.venv/Lib/site-packages/anyio/_backends/_trio.py b/.venv/Lib/site-packages/anyio/_backends/_trio.py new file mode 100644 index 0000000..b80cc04 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_backends/_trio.py @@ -0,0 +1,1334 @@ +from __future__ import annotations + +import array +import math +import os +import socket +import sys +import types +import weakref +from collections.abc import ( + AsyncGenerator, + AsyncIterator, + Awaitable, + Callable, + Collection, + Coroutine, + Iterable, + Sequence, +) +from concurrent.futures import Future +from contextlib import AbstractContextManager +from dataclasses import dataclass +from functools import partial +from io import IOBase +from os import PathLike +from signal import Signals +from socket import AddressFamily, SocketKind +from types import TracebackType +from typing import ( + IO, + TYPE_CHECKING, + Any, + Generic, + NoReturn, + TypeVar, + cast, + overload, +) + +import trio.from_thread +import trio.lowlevel +from outcome import Error, Outcome, Value +from trio.lowlevel import ( + current_root_task, + current_task, + wait_readable, + wait_writable, +) +from trio.socket import SocketType as TrioSocketType +from trio.to_thread import run_sync + +from .. import ( + CapacityLimiterStatistics, + EventStatistics, + LockStatistics, + TaskInfo, + WouldBlock, + abc, +) +from .._core._eventloop import claim_worker_thread +from .._core._exceptions import ( + BrokenResourceError, + BusyResourceError, + ClosedResourceError, + EndOfStream, +) +from .._core._sockets import convert_ipv6_sockaddr +from .._core._streams import create_memory_object_stream +from .._core._synchronization import ( + CapacityLimiter as BaseCapacityLimiter, +) +from .._core._synchronization import Event as BaseEvent +from .._core._synchronization import Lock as BaseLock +from .._core._synchronization import ( + ResourceGuard, + SemaphoreStatistics, +) +from .._core._synchronization import Semaphore as BaseSemaphore +from .._core._tasks import CancelScope as BaseCancelScope +from ..abc import IPSockAddrType, UDPPacketType, UNIXDatagramPacketType +from ..abc._eventloop import AsyncBackend, StrOrBytesPath +from ..streams.memory import MemoryObjectSendStream + +if TYPE_CHECKING: + from _typeshed import HasFileno + +if sys.version_info >= (3, 10): + from typing import ParamSpec +else: + from typing_extensions import ParamSpec + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from exceptiongroup import BaseExceptionGroup + from typing_extensions import TypeVarTuple, Unpack + +T = TypeVar("T") +T_Retval = TypeVar("T_Retval") +T_SockAddr = TypeVar("T_SockAddr", str, IPSockAddrType) +PosArgsT = TypeVarTuple("PosArgsT") +P = ParamSpec("P") + + +# +# Event loop +# + +RunVar = trio.lowlevel.RunVar + + +# +# Timeouts and cancellation +# + + +class CancelScope(BaseCancelScope): + def __new__( + cls, original: trio.CancelScope | None = None, **kwargs: object + ) -> CancelScope: + return object.__new__(cls) + + def __init__(self, original: trio.CancelScope | None = None, **kwargs: Any) -> None: + self.__original = original or trio.CancelScope(**kwargs) + + def __enter__(self) -> CancelScope: + self.__original.__enter__() + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool: + return self.__original.__exit__(exc_type, exc_val, exc_tb) + + def cancel(self) -> None: + self.__original.cancel() + + @property + def deadline(self) -> float: + return self.__original.deadline + + @deadline.setter + def deadline(self, value: float) -> None: + self.__original.deadline = value + + @property + def cancel_called(self) -> bool: + return self.__original.cancel_called + + @property + def cancelled_caught(self) -> bool: + return self.__original.cancelled_caught + + @property + def shield(self) -> bool: + return self.__original.shield + + @shield.setter + def shield(self, value: bool) -> None: + self.__original.shield = value + + +# +# Task groups +# + + +class TaskGroup(abc.TaskGroup): + def __init__(self) -> None: + self._active = False + self._nursery_manager = trio.open_nursery(strict_exception_groups=True) + self.cancel_scope = None # type: ignore[assignment] + + async def __aenter__(self) -> TaskGroup: + self._active = True + self._nursery = await self._nursery_manager.__aenter__() + self.cancel_scope = CancelScope(self._nursery.cancel_scope) + return self + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool: + try: + # trio.Nursery.__exit__ returns bool; .open_nursery has wrong type + return await self._nursery_manager.__aexit__(exc_type, exc_val, exc_tb) # type: ignore[return-value] + except BaseExceptionGroup as exc: + if not exc.split(trio.Cancelled)[1]: + raise trio.Cancelled._create() from exc + + raise + finally: + del exc_val, exc_tb + self._active = False + + def start_soon( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[Any]], + *args: Unpack[PosArgsT], + name: object = None, + ) -> None: + if not self._active: + raise RuntimeError( + "This task group is not active; no new tasks can be started." + ) + + self._nursery.start_soon(func, *args, name=name) + + async def start( + self, func: Callable[..., Awaitable[Any]], *args: object, name: object = None + ) -> Any: + if not self._active: + raise RuntimeError( + "This task group is not active; no new tasks can be started." + ) + + return await self._nursery.start(func, *args, name=name) + + +# +# Threads +# + + +class BlockingPortal(abc.BlockingPortal): + def __new__(cls) -> BlockingPortal: + return object.__new__(cls) + + def __init__(self) -> None: + super().__init__() + self._token = trio.lowlevel.current_trio_token() + + def _spawn_task_from_thread( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + name: object, + future: Future[T_Retval], + ) -> None: + trio.from_thread.run_sync( + partial(self._task_group.start_soon, name=name), + self._call_func, + func, + args, + kwargs, + future, + trio_token=self._token, + ) + + +# +# Subprocesses +# + + +@dataclass(eq=False) +class ReceiveStreamWrapper(abc.ByteReceiveStream): + _stream: trio.abc.ReceiveStream + + async def receive(self, max_bytes: int | None = None) -> bytes: + try: + data = await self._stream.receive_some(max_bytes) + except trio.ClosedResourceError as exc: + raise ClosedResourceError from exc.__cause__ + except trio.BrokenResourceError as exc: + raise BrokenResourceError from exc.__cause__ + + if data: + return data + else: + raise EndOfStream + + async def aclose(self) -> None: + await self._stream.aclose() + + +@dataclass(eq=False) +class SendStreamWrapper(abc.ByteSendStream): + _stream: trio.abc.SendStream + + async def send(self, item: bytes) -> None: + try: + await self._stream.send_all(item) + except trio.ClosedResourceError as exc: + raise ClosedResourceError from exc.__cause__ + except trio.BrokenResourceError as exc: + raise BrokenResourceError from exc.__cause__ + + async def aclose(self) -> None: + await self._stream.aclose() + + +@dataclass(eq=False) +class Process(abc.Process): + _process: trio.Process + _stdin: abc.ByteSendStream | None + _stdout: abc.ByteReceiveStream | None + _stderr: abc.ByteReceiveStream | None + + async def aclose(self) -> None: + with CancelScope(shield=True): + if self._stdin: + await self._stdin.aclose() + if self._stdout: + await self._stdout.aclose() + if self._stderr: + await self._stderr.aclose() + + try: + await self.wait() + except BaseException: + self.kill() + with CancelScope(shield=True): + await self.wait() + raise + + async def wait(self) -> int: + return await self._process.wait() + + def terminate(self) -> None: + self._process.terminate() + + def kill(self) -> None: + self._process.kill() + + def send_signal(self, signal: Signals) -> None: + self._process.send_signal(signal) + + @property + def pid(self) -> int: + return self._process.pid + + @property + def returncode(self) -> int | None: + return self._process.returncode + + @property + def stdin(self) -> abc.ByteSendStream | None: + return self._stdin + + @property + def stdout(self) -> abc.ByteReceiveStream | None: + return self._stdout + + @property + def stderr(self) -> abc.ByteReceiveStream | None: + return self._stderr + + +class _ProcessPoolShutdownInstrument(trio.abc.Instrument): + def after_run(self) -> None: + super().after_run() + + +current_default_worker_process_limiter: trio.lowlevel.RunVar = RunVar( + "current_default_worker_process_limiter" +) + + +async def _shutdown_process_pool(workers: set[abc.Process]) -> None: + try: + await trio.sleep(math.inf) + except trio.Cancelled: + for process in workers: + if process.returncode is None: + process.kill() + + with CancelScope(shield=True): + for process in workers: + await process.aclose() + + +# +# Sockets and networking +# + + +class _TrioSocketMixin(Generic[T_SockAddr]): + def __init__(self, trio_socket: TrioSocketType) -> None: + self._trio_socket = trio_socket + self._closed = False + + def _check_closed(self) -> None: + if self._closed: + raise ClosedResourceError + if self._trio_socket.fileno() < 0: + raise BrokenResourceError + + @property + def _raw_socket(self) -> socket.socket: + return self._trio_socket._sock # type: ignore[attr-defined] + + async def aclose(self) -> None: + if self._trio_socket.fileno() >= 0: + self._closed = True + self._trio_socket.close() + + def _convert_socket_error(self, exc: BaseException) -> NoReturn: + if isinstance(exc, trio.ClosedResourceError): + raise ClosedResourceError from exc + elif self._trio_socket.fileno() < 0 and self._closed: + raise ClosedResourceError from None + elif isinstance(exc, OSError): + raise BrokenResourceError from exc + else: + raise exc + + +class SocketStream(_TrioSocketMixin, abc.SocketStream): + def __init__(self, trio_socket: TrioSocketType) -> None: + super().__init__(trio_socket) + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + + async def receive(self, max_bytes: int = 65536) -> bytes: + with self._receive_guard: + try: + data = await self._trio_socket.recv(max_bytes) + except BaseException as exc: + self._convert_socket_error(exc) + + if data: + return data + else: + raise EndOfStream + + async def send(self, item: bytes) -> None: + with self._send_guard: + view = memoryview(item) + while view: + try: + bytes_sent = await self._trio_socket.send(view) + except BaseException as exc: + self._convert_socket_error(exc) + + view = view[bytes_sent:] + + async def send_eof(self) -> None: + self._trio_socket.shutdown(socket.SHUT_WR) + + +class UNIXSocketStream(SocketStream, abc.UNIXSocketStream): + async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]: + if not isinstance(msglen, int) or msglen < 0: + raise ValueError("msglen must be a non-negative integer") + if not isinstance(maxfds, int) or maxfds < 1: + raise ValueError("maxfds must be a positive integer") + + fds = array.array("i") + await trio.lowlevel.checkpoint() + with self._receive_guard: + while True: + try: + message, ancdata, flags, addr = await self._trio_socket.recvmsg( + msglen, socket.CMSG_LEN(maxfds * fds.itemsize) + ) + except BaseException as exc: + self._convert_socket_error(exc) + else: + if not message and not ancdata: + raise EndOfStream + + break + + for cmsg_level, cmsg_type, cmsg_data in ancdata: + if cmsg_level != socket.SOL_SOCKET or cmsg_type != socket.SCM_RIGHTS: + raise RuntimeError( + f"Received unexpected ancillary data; message = {message!r}, " + f"cmsg_level = {cmsg_level}, cmsg_type = {cmsg_type}" + ) + + fds.frombytes(cmsg_data[: len(cmsg_data) - (len(cmsg_data) % fds.itemsize)]) + + return message, list(fds) + + async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None: + if not message: + raise ValueError("message must not be empty") + if not fds: + raise ValueError("fds must not be empty") + + filenos: list[int] = [] + for fd in fds: + if isinstance(fd, int): + filenos.append(fd) + elif isinstance(fd, IOBase): + filenos.append(fd.fileno()) + + fdarray = array.array("i", filenos) + await trio.lowlevel.checkpoint() + with self._send_guard: + while True: + try: + await self._trio_socket.sendmsg( + [message], + [ + ( + socket.SOL_SOCKET, + socket.SCM_RIGHTS, + fdarray, + ) + ], + ) + break + except BaseException as exc: + self._convert_socket_error(exc) + + +class TCPSocketListener(_TrioSocketMixin, abc.SocketListener): + def __init__(self, raw_socket: socket.socket): + super().__init__(trio.socket.from_stdlib_socket(raw_socket)) + self._accept_guard = ResourceGuard("accepting connections from") + + async def accept(self) -> SocketStream: + with self._accept_guard: + try: + trio_socket, _addr = await self._trio_socket.accept() + except BaseException as exc: + self._convert_socket_error(exc) + + trio_socket.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + return SocketStream(trio_socket) + + +class UNIXSocketListener(_TrioSocketMixin, abc.SocketListener): + def __init__(self, raw_socket: socket.socket): + super().__init__(trio.socket.from_stdlib_socket(raw_socket)) + self._accept_guard = ResourceGuard("accepting connections from") + + async def accept(self) -> UNIXSocketStream: + with self._accept_guard: + try: + trio_socket, _addr = await self._trio_socket.accept() + except BaseException as exc: + self._convert_socket_error(exc) + + return UNIXSocketStream(trio_socket) + + +class UDPSocket(_TrioSocketMixin[IPSockAddrType], abc.UDPSocket): + def __init__(self, trio_socket: TrioSocketType) -> None: + super().__init__(trio_socket) + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + + async def receive(self) -> tuple[bytes, IPSockAddrType]: + with self._receive_guard: + try: + data, addr = await self._trio_socket.recvfrom(65536) + return data, convert_ipv6_sockaddr(addr) + except BaseException as exc: + self._convert_socket_error(exc) + + async def send(self, item: UDPPacketType) -> None: + with self._send_guard: + try: + await self._trio_socket.sendto(*item) + except BaseException as exc: + self._convert_socket_error(exc) + + +class ConnectedUDPSocket(_TrioSocketMixin[IPSockAddrType], abc.ConnectedUDPSocket): + def __init__(self, trio_socket: TrioSocketType) -> None: + super().__init__(trio_socket) + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + + async def receive(self) -> bytes: + with self._receive_guard: + try: + return await self._trio_socket.recv(65536) + except BaseException as exc: + self._convert_socket_error(exc) + + async def send(self, item: bytes) -> None: + with self._send_guard: + try: + await self._trio_socket.send(item) + except BaseException as exc: + self._convert_socket_error(exc) + + +class UNIXDatagramSocket(_TrioSocketMixin[str], abc.UNIXDatagramSocket): + def __init__(self, trio_socket: TrioSocketType) -> None: + super().__init__(trio_socket) + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + + async def receive(self) -> UNIXDatagramPacketType: + with self._receive_guard: + try: + data, addr = await self._trio_socket.recvfrom(65536) + return data, addr + except BaseException as exc: + self._convert_socket_error(exc) + + async def send(self, item: UNIXDatagramPacketType) -> None: + with self._send_guard: + try: + await self._trio_socket.sendto(*item) + except BaseException as exc: + self._convert_socket_error(exc) + + +class ConnectedUNIXDatagramSocket( + _TrioSocketMixin[str], abc.ConnectedUNIXDatagramSocket +): + def __init__(self, trio_socket: TrioSocketType) -> None: + super().__init__(trio_socket) + self._receive_guard = ResourceGuard("reading from") + self._send_guard = ResourceGuard("writing to") + + async def receive(self) -> bytes: + with self._receive_guard: + try: + return await self._trio_socket.recv(65536) + except BaseException as exc: + self._convert_socket_error(exc) + + async def send(self, item: bytes) -> None: + with self._send_guard: + try: + await self._trio_socket.send(item) + except BaseException as exc: + self._convert_socket_error(exc) + + +# +# Synchronization +# + + +class Event(BaseEvent): + def __new__(cls) -> Event: + return object.__new__(cls) + + def __init__(self) -> None: + self.__original = trio.Event() + + def is_set(self) -> bool: + return self.__original.is_set() + + async def wait(self) -> None: + return await self.__original.wait() + + def statistics(self) -> EventStatistics: + orig_statistics = self.__original.statistics() + return EventStatistics(tasks_waiting=orig_statistics.tasks_waiting) + + def set(self) -> None: + self.__original.set() + + +class Lock(BaseLock): + def __new__(cls, *, fast_acquire: bool = False) -> Lock: + return object.__new__(cls) + + def __init__(self, *, fast_acquire: bool = False) -> None: + self._fast_acquire = fast_acquire + self.__original = trio.Lock() + + @staticmethod + def _convert_runtime_error_msg(exc: RuntimeError) -> None: + if exc.args == ("attempt to re-acquire an already held Lock",): + exc.args = ("Attempted to acquire an already held Lock",) + + async def acquire(self) -> None: + if not self._fast_acquire: + try: + await self.__original.acquire() + except RuntimeError as exc: + self._convert_runtime_error_msg(exc) + raise + + return + + # This is the "fast path" where we don't let other tasks run + await trio.lowlevel.checkpoint_if_cancelled() + try: + self.__original.acquire_nowait() + except trio.WouldBlock: + await self.__original._lot.park() + except RuntimeError as exc: + self._convert_runtime_error_msg(exc) + raise + + def acquire_nowait(self) -> None: + try: + self.__original.acquire_nowait() + except trio.WouldBlock: + raise WouldBlock from None + except RuntimeError as exc: + self._convert_runtime_error_msg(exc) + raise + + def locked(self) -> bool: + return self.__original.locked() + + def release(self) -> None: + self.__original.release() + + def statistics(self) -> LockStatistics: + orig_statistics = self.__original.statistics() + owner = TrioTaskInfo(orig_statistics.owner) if orig_statistics.owner else None + return LockStatistics( + orig_statistics.locked, owner, orig_statistics.tasks_waiting + ) + + +class Semaphore(BaseSemaphore): + def __new__( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> Semaphore: + return object.__new__(cls) + + def __init__( + self, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> None: + super().__init__(initial_value, max_value=max_value, fast_acquire=fast_acquire) + self.__original = trio.Semaphore(initial_value, max_value=max_value) + + async def acquire(self) -> None: + if not self._fast_acquire: + await self.__original.acquire() + return + + # This is the "fast path" where we don't let other tasks run + await trio.lowlevel.checkpoint_if_cancelled() + try: + self.__original.acquire_nowait() + except trio.WouldBlock: + await self.__original._lot.park() + + def acquire_nowait(self) -> None: + try: + self.__original.acquire_nowait() + except trio.WouldBlock: + raise WouldBlock from None + + @property + def max_value(self) -> int | None: + return self.__original.max_value + + @property + def value(self) -> int: + return self.__original.value + + def release(self) -> None: + self.__original.release() + + def statistics(self) -> SemaphoreStatistics: + orig_statistics = self.__original.statistics() + return SemaphoreStatistics(orig_statistics.tasks_waiting) + + +class CapacityLimiter(BaseCapacityLimiter): + def __new__( + cls, + total_tokens: float | None = None, + *, + original: trio.CapacityLimiter | None = None, + ) -> CapacityLimiter: + return object.__new__(cls) + + def __init__( + self, + total_tokens: float | None = None, + *, + original: trio.CapacityLimiter | None = None, + ) -> None: + if original is not None: + self.__original = original + else: + assert total_tokens is not None + self.__original = trio.CapacityLimiter(total_tokens) + + async def __aenter__(self) -> None: + return await self.__original.__aenter__() + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + await self.__original.__aexit__(exc_type, exc_val, exc_tb) + + @property + def total_tokens(self) -> float: + return self.__original.total_tokens + + @total_tokens.setter + def total_tokens(self, value: float) -> None: + self.__original.total_tokens = value + + @property + def borrowed_tokens(self) -> int: + return self.__original.borrowed_tokens + + @property + def available_tokens(self) -> float: + return self.__original.available_tokens + + def acquire_nowait(self) -> None: + self.__original.acquire_nowait() + + def acquire_on_behalf_of_nowait(self, borrower: object) -> None: + self.__original.acquire_on_behalf_of_nowait(borrower) + + async def acquire(self) -> None: + await self.__original.acquire() + + async def acquire_on_behalf_of(self, borrower: object) -> None: + await self.__original.acquire_on_behalf_of(borrower) + + def release(self) -> None: + return self.__original.release() + + def release_on_behalf_of(self, borrower: object) -> None: + return self.__original.release_on_behalf_of(borrower) + + def statistics(self) -> CapacityLimiterStatistics: + orig = self.__original.statistics() + return CapacityLimiterStatistics( + borrowed_tokens=orig.borrowed_tokens, + total_tokens=orig.total_tokens, + borrowers=tuple(orig.borrowers), + tasks_waiting=orig.tasks_waiting, + ) + + +_capacity_limiter_wrapper: trio.lowlevel.RunVar = RunVar("_capacity_limiter_wrapper") + + +# +# Signal handling +# + + +class _SignalReceiver: + _iterator: AsyncIterator[int] + + def __init__(self, signals: tuple[Signals, ...]): + self._signals = signals + + def __enter__(self) -> _SignalReceiver: + self._cm = trio.open_signal_receiver(*self._signals) + self._iterator = self._cm.__enter__() + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + return self._cm.__exit__(exc_type, exc_val, exc_tb) + + def __aiter__(self) -> _SignalReceiver: + return self + + async def __anext__(self) -> Signals: + signum = await self._iterator.__anext__() + return Signals(signum) + + +# +# Testing and debugging +# + + +class TestRunner(abc.TestRunner): + def __init__(self, **options: Any) -> None: + from queue import Queue + + self._call_queue: Queue[Callable[[], object]] = Queue() + self._send_stream: MemoryObjectSendStream | None = None + self._options = options + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: types.TracebackType | None, + ) -> None: + if self._send_stream: + self._send_stream.close() + while self._send_stream is not None: + self._call_queue.get()() + + async def _run_tests_and_fixtures(self) -> None: + self._send_stream, receive_stream = create_memory_object_stream(1) + with receive_stream: + async for coro, outcome_holder in receive_stream: + try: + retval = await coro + except BaseException as exc: + outcome_holder.append(Error(exc)) + else: + outcome_holder.append(Value(retval)) + + def _main_task_finished(self, outcome: object) -> None: + self._send_stream = None + + def _call_in_runner_task( + self, + func: Callable[P, Awaitable[T_Retval]], + *args: P.args, + **kwargs: P.kwargs, + ) -> T_Retval: + if self._send_stream is None: + trio.lowlevel.start_guest_run( + self._run_tests_and_fixtures, + run_sync_soon_threadsafe=self._call_queue.put, + done_callback=self._main_task_finished, + **self._options, + ) + while self._send_stream is None: + self._call_queue.get()() + + outcome_holder: list[Outcome] = [] + self._send_stream.send_nowait((func(*args, **kwargs), outcome_holder)) + while not outcome_holder: + self._call_queue.get()() + + return outcome_holder[0].unwrap() + + def run_asyncgen_fixture( + self, + fixture_func: Callable[..., AsyncGenerator[T_Retval, Any]], + kwargs: dict[str, Any], + ) -> Iterable[T_Retval]: + asyncgen = fixture_func(**kwargs) + fixturevalue: T_Retval = self._call_in_runner_task(asyncgen.asend, None) + + yield fixturevalue + + try: + self._call_in_runner_task(asyncgen.asend, None) + except StopAsyncIteration: + pass + else: + self._call_in_runner_task(asyncgen.aclose) + raise RuntimeError("Async generator fixture did not stop") + + def run_fixture( + self, + fixture_func: Callable[..., Coroutine[Any, Any, T_Retval]], + kwargs: dict[str, Any], + ) -> T_Retval: + return self._call_in_runner_task(fixture_func, **kwargs) + + def run_test( + self, test_func: Callable[..., Coroutine[Any, Any, Any]], kwargs: dict[str, Any] + ) -> None: + self._call_in_runner_task(test_func, **kwargs) + + +class TrioTaskInfo(TaskInfo): + def __init__(self, task: trio.lowlevel.Task): + parent_id = None + if task.parent_nursery and task.parent_nursery.parent_task: + parent_id = id(task.parent_nursery.parent_task) + + super().__init__(id(task), parent_id, task.name, task.coro) + self._task = weakref.proxy(task) + + def has_pending_cancellation(self) -> bool: + try: + return self._task._cancel_status.effectively_cancelled + except ReferenceError: + # If the task is no longer around, it surely doesn't have a cancellation + # pending + return False + + +class TrioBackend(AsyncBackend): + @classmethod + def run( + cls, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + options: dict[str, Any], + ) -> T_Retval: + return trio.run(func, *args) + + @classmethod + def current_token(cls) -> object: + return trio.lowlevel.current_trio_token() + + @classmethod + def current_time(cls) -> float: + return trio.current_time() + + @classmethod + def cancelled_exception_class(cls) -> type[BaseException]: + return trio.Cancelled + + @classmethod + async def checkpoint(cls) -> None: + await trio.lowlevel.checkpoint() + + @classmethod + async def checkpoint_if_cancelled(cls) -> None: + await trio.lowlevel.checkpoint_if_cancelled() + + @classmethod + async def cancel_shielded_checkpoint(cls) -> None: + await trio.lowlevel.cancel_shielded_checkpoint() + + @classmethod + async def sleep(cls, delay: float) -> None: + await trio.sleep(delay) + + @classmethod + def create_cancel_scope( + cls, *, deadline: float = math.inf, shield: bool = False + ) -> abc.CancelScope: + return CancelScope(deadline=deadline, shield=shield) + + @classmethod + def current_effective_deadline(cls) -> float: + return trio.current_effective_deadline() + + @classmethod + def create_task_group(cls) -> abc.TaskGroup: + return TaskGroup() + + @classmethod + def create_event(cls) -> abc.Event: + return Event() + + @classmethod + def create_lock(cls, *, fast_acquire: bool) -> Lock: + return Lock(fast_acquire=fast_acquire) + + @classmethod + def create_semaphore( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> abc.Semaphore: + return Semaphore(initial_value, max_value=max_value, fast_acquire=fast_acquire) + + @classmethod + def create_capacity_limiter(cls, total_tokens: float) -> CapacityLimiter: + return CapacityLimiter(total_tokens) + + @classmethod + async def run_sync_in_worker_thread( + cls, + func: Callable[[Unpack[PosArgsT]], T_Retval], + args: tuple[Unpack[PosArgsT]], + abandon_on_cancel: bool = False, + limiter: abc.CapacityLimiter | None = None, + ) -> T_Retval: + def wrapper() -> T_Retval: + with claim_worker_thread(TrioBackend, token): + return func(*args) + + token = TrioBackend.current_token() + return await run_sync( + wrapper, + abandon_on_cancel=abandon_on_cancel, + limiter=cast(trio.CapacityLimiter, limiter), + ) + + @classmethod + def check_cancelled(cls) -> None: + trio.from_thread.check_cancelled() + + @classmethod + def run_async_from_thread( + cls, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + args: tuple[Unpack[PosArgsT]], + token: object, + ) -> T_Retval: + return trio.from_thread.run(func, *args) + + @classmethod + def run_sync_from_thread( + cls, + func: Callable[[Unpack[PosArgsT]], T_Retval], + args: tuple[Unpack[PosArgsT]], + token: object, + ) -> T_Retval: + return trio.from_thread.run_sync(func, *args) + + @classmethod + def create_blocking_portal(cls) -> abc.BlockingPortal: + return BlockingPortal() + + @classmethod + async def open_process( + cls, + command: StrOrBytesPath | Sequence[StrOrBytesPath], + *, + stdin: int | IO[Any] | None, + stdout: int | IO[Any] | None, + stderr: int | IO[Any] | None, + **kwargs: Any, + ) -> Process: + def convert_item(item: StrOrBytesPath) -> str: + str_or_bytes = os.fspath(item) + if isinstance(str_or_bytes, str): + return str_or_bytes + else: + return os.fsdecode(str_or_bytes) + + if isinstance(command, (str, bytes, PathLike)): + process = await trio.lowlevel.open_process( + convert_item(command), + stdin=stdin, + stdout=stdout, + stderr=stderr, + shell=True, + **kwargs, + ) + else: + process = await trio.lowlevel.open_process( + [convert_item(item) for item in command], + stdin=stdin, + stdout=stdout, + stderr=stderr, + shell=False, + **kwargs, + ) + + stdin_stream = SendStreamWrapper(process.stdin) if process.stdin else None + stdout_stream = ReceiveStreamWrapper(process.stdout) if process.stdout else None + stderr_stream = ReceiveStreamWrapper(process.stderr) if process.stderr else None + return Process(process, stdin_stream, stdout_stream, stderr_stream) + + @classmethod + def setup_process_pool_exit_at_shutdown(cls, workers: set[abc.Process]) -> None: + trio.lowlevel.spawn_system_task(_shutdown_process_pool, workers) + + @classmethod + async def connect_tcp( + cls, host: str, port: int, local_address: IPSockAddrType | None = None + ) -> SocketStream: + family = socket.AF_INET6 if ":" in host else socket.AF_INET + trio_socket = trio.socket.socket(family) + trio_socket.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + if local_address: + await trio_socket.bind(local_address) + + try: + await trio_socket.connect((host, port)) + except BaseException: + trio_socket.close() + raise + + return SocketStream(trio_socket) + + @classmethod + async def connect_unix(cls, path: str | bytes) -> abc.UNIXSocketStream: + trio_socket = trio.socket.socket(socket.AF_UNIX) + try: + await trio_socket.connect(path) + except BaseException: + trio_socket.close() + raise + + return UNIXSocketStream(trio_socket) + + @classmethod + def create_tcp_listener(cls, sock: socket.socket) -> abc.SocketListener: + return TCPSocketListener(sock) + + @classmethod + def create_unix_listener(cls, sock: socket.socket) -> abc.SocketListener: + return UNIXSocketListener(sock) + + @classmethod + async def create_udp_socket( + cls, + family: socket.AddressFamily, + local_address: IPSockAddrType | None, + remote_address: IPSockAddrType | None, + reuse_port: bool, + ) -> UDPSocket | ConnectedUDPSocket: + trio_socket = trio.socket.socket(family=family, type=socket.SOCK_DGRAM) + + if reuse_port: + trio_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1) + + if local_address: + await trio_socket.bind(local_address) + + if remote_address: + await trio_socket.connect(remote_address) + return ConnectedUDPSocket(trio_socket) + else: + return UDPSocket(trio_socket) + + @classmethod + @overload + async def create_unix_datagram_socket( + cls, raw_socket: socket.socket, remote_path: None + ) -> abc.UNIXDatagramSocket: ... + + @classmethod + @overload + async def create_unix_datagram_socket( + cls, raw_socket: socket.socket, remote_path: str | bytes + ) -> abc.ConnectedUNIXDatagramSocket: ... + + @classmethod + async def create_unix_datagram_socket( + cls, raw_socket: socket.socket, remote_path: str | bytes | None + ) -> abc.UNIXDatagramSocket | abc.ConnectedUNIXDatagramSocket: + trio_socket = trio.socket.from_stdlib_socket(raw_socket) + + if remote_path: + await trio_socket.connect(remote_path) + return ConnectedUNIXDatagramSocket(trio_socket) + else: + return UNIXDatagramSocket(trio_socket) + + @classmethod + async def getaddrinfo( + cls, + host: bytes | str | None, + port: str | int | None, + *, + family: int | AddressFamily = 0, + type: int | SocketKind = 0, + proto: int = 0, + flags: int = 0, + ) -> Sequence[ + tuple[ + AddressFamily, + SocketKind, + int, + str, + tuple[str, int] | tuple[str, int, int, int] | tuple[int, bytes], + ] + ]: + return await trio.socket.getaddrinfo(host, port, family, type, proto, flags) + + @classmethod + async def getnameinfo( + cls, sockaddr: IPSockAddrType, flags: int = 0 + ) -> tuple[str, str]: + return await trio.socket.getnameinfo(sockaddr, flags) + + @classmethod + async def wait_readable(cls, obj: HasFileno | int) -> None: + try: + await wait_readable(obj) + except trio.ClosedResourceError as exc: + raise ClosedResourceError().with_traceback(exc.__traceback__) from None + except trio.BusyResourceError: + raise BusyResourceError("reading from") from None + + @classmethod + async def wait_writable(cls, obj: HasFileno | int) -> None: + try: + await wait_writable(obj) + except trio.ClosedResourceError as exc: + raise ClosedResourceError().with_traceback(exc.__traceback__) from None + except trio.BusyResourceError: + raise BusyResourceError("writing to") from None + + @classmethod + def current_default_thread_limiter(cls) -> CapacityLimiter: + try: + return _capacity_limiter_wrapper.get() + except LookupError: + limiter = CapacityLimiter( + original=trio.to_thread.current_default_thread_limiter() + ) + _capacity_limiter_wrapper.set(limiter) + return limiter + + @classmethod + def open_signal_receiver( + cls, *signals: Signals + ) -> AbstractContextManager[AsyncIterator[Signals]]: + return _SignalReceiver(signals) + + @classmethod + def get_current_task(cls) -> TaskInfo: + task = current_task() + return TrioTaskInfo(task) + + @classmethod + def get_running_tasks(cls) -> Sequence[TaskInfo]: + root_task = current_root_task() + assert root_task + task_infos = [TrioTaskInfo(root_task)] + nurseries = root_task.child_nurseries + while nurseries: + new_nurseries: list[trio.Nursery] = [] + for nursery in nurseries: + for task in nursery.child_tasks: + task_infos.append(TrioTaskInfo(task)) + new_nurseries.extend(task.child_nurseries) + + nurseries = new_nurseries + + return task_infos + + @classmethod + async def wait_all_tasks_blocked(cls) -> None: + from trio.testing import wait_all_tasks_blocked + + await wait_all_tasks_blocked() + + @classmethod + def create_test_runner(cls, options: dict[str, Any]) -> TestRunner: + return TestRunner(**options) + + +backend_class = TrioBackend diff --git a/.venv/Lib/site-packages/anyio/_core/__init__.py b/.venv/Lib/site-packages/anyio/_core/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..816f038c270b0df3fed4265a78c6c20c4a2adad5 GIT binary patch literal 209 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_fileio.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_fileio.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ef680f0df4d07959bfbc9c26436c306819934a64 GIT binary patch literal 41633 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 AzyJUM literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_resources.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_resources.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2b8f28b8efdd0aa7c4f05e8ed443e4c8adf03c06 GIT binary patch literal 951 zcmY*XO=#3W6rR~^vfJJ6f=cVDZ1CrhLw`JoxQMdUn^KD6p-Ui4lj&~S>`a(Rx<)IA z6|qq1&3f`K)q@INrDrdK2TPzJh+uC*3l{Ol9YICTI-)LQIvaPN-=A*}mz|+tQEdcu3qO(xMQLB|e{Y zTrTLOlVz6^VUnKcSLG~l*q4Pk2oh0+YEo`V!1WOW z+QxdLRM<8O;Fz)Uq6`9|)+jXujbg#l{0wK*Dx@XHS%|?y9Y?4=Of@p^4yaB<o xx>x!uv=0m>U34Cj;4|#N%vSH z;=zj-ul^0<#s9;L;)2pJu&{XWHZY#{?>0Ak1jokie)ghC z$iHs08Vzp*hr4LJA}L7&LGoZ61kP@VM&2AZE4wLLd3)Th?3U={-EkM~cG?kZ`TBT0 zAnWy)uBYASt#Pkh8}z=q@PlC4r&20QEmzXucJrz!WwK+LrdDbEaq{ZaSWOdqO-aih z*_%|-jJcEUh-Z=t^EL31j%Cco)LoCKG+K zItGK^S(t?|nfQz0Xy^LQtv@G|fxoYroohJ+DxqRG(@Ltjfy4^}xmN`4EB%uXuZ4uY z8Bb_7PK9KW#%Czxt!w~kUmPltfggacOYR^Ebm;rnyF!Q2N$iAis5{WOE zD8VS;7Px^aGuCmV3&qo;Od5SEtt8kPdT|MfR>o`>0+zC|En^Bnxrky@Vcl z@>FvZ?Uu=m>U>wL2Q0BBD)d&yr0;-8sLVuDoMTid&gTy=UWh^jzKCw{X=Lz$w+gIw z>Sy}FhKpXzp%(M#sj_hN>Gt$T$^=!(i~qBqe~Z#eh0OSwwtf?d%kaO-3? r1Dp<;K@jYdvtP(ypKR@uQ)nD?js;gf|8nA>iR(Y@?Qd;dt5DwoUj2bZ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_sockets.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_sockets.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e7d6d1fc92e2843d1aace136a8b44f0fddf3f694 GIT binary patch literal 31525 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 S@MNsyLw6M2%!7}qJO3X;X?XVl literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_streams.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_streams.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb49a3d0ffa10e6f4a866907db1aac288f5e48d4 GIT binary patch literal 2357 zcmb7FO>7fK6rQ!$8~-ISX@QbZGy+6p1Z$*HRkbQqpg$mJ5}H6&W3<`qj_oD;?@a>i8bAtzhQI=NcT$=C7{Nf9QSL#tAJYORnW9}zQqo0vIPWI0wi02?eD|2I;& zT1_Xm!<|$){{$ChDJj_<0p6gG+dT6fGX4iBMqP(ng_el!v(&2%Rnd9-!^ukSM zh)u|)BPPc1-41tfwRx=R-rO_Ib+YFmpe`k>kfT%$Vw5&+lZFmKE!E~;&v>kf7F zFSLcA(O_KjtuCulH*gjhr(PrS>(dsqO=`JR0HoNE2ClGdIzR72b|=g8^8i)n!jFJp zgbTK3ELv_eMi%?QAT$i3N1p-U;4n(B`V2yP zSpq-v0**{UPTrVQRTV?GTwgHVRO47V69IRtaJeFA+YCdT#4IJ3d4hs>k0zlsLfD}8x2vG)ri*VmcSYEq_OODmF@ zS_B)ub3eUfKlRm^C=9-oMR6c!?kW8emWUYb>qV(AVUe#4e0`Y~uk?3T1|G!T|LPj4 zSyCRF>b|v$nbZkTj2__fQLK$|7j z6M1p1%KziZfF&HS2AWwO$ZIUxY>CEC{6AnX<{1jRu(4FJua%}b-`#OhaPs(zb zHf%o}-IaBf7<7(btnVw*LBO}mS3Og7%iPUGu*>I>(|@-WK@p2 z@Oa(!ntmNhy{YN#w&nzj@0_ZuOUzxWU$z$NKDasAh9LDOgY(>uUZ+Dex)SEP+Y zM-t(5H5UHJU3r$lt@tQBr96TF8UeIA0Kl<#aclsg0{tE7h=dBW_+G=xk7+xSw0AXr z^&*bOY#op{%tXnGksiTQ2k67>yK%s0co{aZf%%tV+Dc23v`G#>CWTEhzDW-JEz45s zDZ!~o@_W90Z9O-BOL?Xol^{4d*UQtp`_}T4z2oP9`Ec#{rC$Ehntb_r8n+{F{{ow_ Bn@#`# literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_subprocesses.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_subprocesses.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc4696ee05600d3d7c4b48bb77ea0328da069947 GIT binary patch literal 9649 zcmeG?ZEPIZac}RNM-=EN6dh8DbEbM+-Y%&X_jWID z_e4=Wxw4hElA$&-Tu1t$9}Zxka+RR@SrlktA%c{me@N2>&kHLSkOZjyo#7Oci2~`& zdw0j9NGWg}xc<>4@7?U%_vX#ao0&H=d;bv#)DpP-V|QkaE<%2dH{~nL0pZhs5eT_V zjuM&3f<`hzQV+@>iOe7h})FZHZ$0- zwPae8tpZUTC-#*IUi+29p#+qG97PEJh}_0LP1rpRN|NGqm!kWz!%;pdG^ zR#U7>H!SHGIbu79^aa~}R0lF_S6VWydk#*Yw>148=o``-nN_Tmgfyn6rSzPl%h;Kw ziexD%OETwDv((6C&mHCtj5<=d6S;;h0GqP#Ba;5_K7&o?GIb~6a zvu4`vTm~3TqeSou!3XW~93jG|?*ZF?)A%hSfOX2=^NlltEd0=aCY*P?8psQ;)>-9Q zV58Sd@N0sF!eUpRy4JTjQe^Cs2c6$^Uu`hBPV?2ackeSBVT`_ zZtcDd<-?ngm)+M(oCyR*_{-zhz8{Nmlku`=9mW#>Yxuy!90Ca*gw-~Ab|O+elEZnS zybl#Ay0{b=&6{C~Zp2cS<)%0qKhJpXcdn!T!F3LHjqPk{XTZ}kzqH|bY3BuUp>Y!C zo{64m$h+y+|1xqS#xYg5vU_enNNSsfZkAnETLo$_LmiQ2tsGuJ7b@QPM@Qe}(Fj zCZ>%{M$%KQzO=r1xg)y=?FR7N8(=AmK0f3Rr)0zXd4Aa1XXex@NnMNWZCT4Pa zIx)3|V1VZIDLycfm8g^{uapoK)jFZLnW98za~VaqID!&U%=son z=BpVMid>kBCmPcyl(fZUF*ORvr=Ak0rWiR>Q=)Ma4hU6NKyb&^bxiRy z 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 E0oq1}N&o-= literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_synchronization.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_synchronization.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..51aeac6ceef2d17059cb7e4de5808e9587caf348 GIT binary patch literal 32180 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_tasks.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_tasks.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..962f5dca00d2a544384cd86ae5d6dffa5d72ae8c GIT binary patch literal 7009 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_tempfile.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_tempfile.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3acb792ada79affa4b103bfca3109d76140f7f7d GIT binary patch literal 28153 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_testing.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_testing.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a25d3a183f6e5df69cc36ab26ae13839e9f3e9af GIT binary patch literal 3589 zcmaJDT}&LudFF2Se)fRFHrS>CcS8yCI{0wX#3XjyD0O5+5@8zBADwZRWp{yvz1{Q7 zp3z-Ng&M1})I^G3N~1LOE0z`YwU6mjBK74ckwB|PiPThW-iXdpD?j!7X7AR=nRZY2 z%{MdOeDlrs|CjD=g}~Q6^TpDY3?YBVN$Zm$gf^A|*(4URs7p$;NGak8H&IF!lO?Gr ziFwkMOQ~Y2lrE-WE?KghDP@aUN)lv}SgBjYO5aaJ9E*z8Wo2$j#hle`Wnt{HdMpLT z?rKiUe}hCC4ReO)`GFBQzQ?shn0;l@;2e;Lb;n19+qU$B!s<^hUhh4gUqhh%DGF@j~aGrG| z=s}Q2&j#l!YOX|dv&90frSRMm&&%NOQ;%x%W!498*)pPQ+g%LXgWFdr4p z=gREtQY)zDTz`qrEdbPwa#=4`R$n|fSGZ|=H|O4P7UsAU*k{WSSjLhK{Jg5;kLzFo zdt47}4yIiyl&fJz*B#FZbiH<@6%&Ql(s2-sUk0#29`ul2^|rKka`0~cgM9tO=`Ff7 zvU}#@_L+-y?WKDErQ6cG%HD|q7}9%B6=3MuQ%7LP?!A2Zw)9@M0c?obZc((2u>CwB zn!~B%C2340JSYG!SLas>_d1nj-se4JBdpvUAJ$5s`72B!i5poXM(bUpU+0JFnIZNapfuy>!UUaGsA3F|1F9g01;PF1 z*;&E{;Q%C8Y1!b*;x+fEke(w+Q))0VZg-eCS~>${9Q_m|&mVjL)y>H}lfQYpo*8^x zNYthfGAc7*4_N5@4ii_z?4j2CFkwMluEchF#0_?mAEjoACQa9*(~fnimL3zC?NUfJ zuw+)(P1oQY;t-zKj6o58BJ#cmoH|s%AisC0AX++$v;_bgWbf$l&BC3+?on;~s8&C6 zW@}_C_~Y8WwXM}Zo%p2h(}6z^eA4~dkLvlW^~}}B6@=0Y1xbKxk}A~_HC^OIjO{n= zpu#+Le*P_1vFGP8!(;itw4#D7R6{kswt29&g}P*BNsQO_N6ZQRr*y|eqTmpKSlaZ?WYBrA^Cy*tUwi# zf1!~>v@s~jry5;U9%`hhJVPI(WI58SxXOeJ;t!LJaG_@bX-@?An==R$g^4u;FTkH;?iBT+ zYiK8TYBx8&og3fDJyVySi6REJ;|~k6cvNHs60~5!yY8K z)(WlbT9RP^34Mj4$8FxMBLm*4y$Pg6@I&}>41`E~z4c!8^WpFB3_rg+Jh?qQxidVq zlY6Z$z4o{oQC06?7c~RO>x3RqWlKf>&vV{^uId-S<+q8=T%OqH3=xkvM`fhj%!vZCY3a5pq zprb?qf!9S*Aq*)V@ieZ*2_?+D6!nZhU@yZ47G{olXFo|P{eletlbrjK4E}>?|4xn3 a{%;9@#?NV*KHKO^)7R;Pz66~R-2MyM_D2K& literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/__pycache__/_typedattr.cpython-312.pyc b/.venv/Lib/site-packages/anyio/_core/__pycache__/_typedattr.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..69ed48875efffa7c20c5e274711307636400bac1 GIT binary patch literal 3854 zcma)9U1%KF6~6Pc|0}J2B1KAyJ&qN}>q@ek)NUi1wyu=at{vCJb|Gt-$?VLPG}i3Q z=H6LJyR3sSqE&DLp->d)52g<#K`(vnOUYxQeXwdm=h?fOIOmhOeIsxR^Zl6@EKyEh`) zm6FwMWmnZok4%0{tlTQG@*8sWWv@6Zz*#Xl>uYwEOP?V@Sqch<>w3Q7+n&qIa*&-e z9LK0SG|0Sa)a$l8S5^b%l-mq4mzs6@GlK=GS=%+7AnPqs=6Htn8EOffhLONJ<@?O8 zHhg-{^A;NQml^X|kiMkjd62uLPt#eW;rM2#UpS+(3L(bBF`Lg^Xqxi|t6g9oGUPLLHa16H$_(FQGmbaMXR0vk;19jlSa@+_W_*#li!I}DiI#xH#1!Il^KeuUn$92g2+Y3#?@&^aEK-pzsiIiQ8kv;M z=Xnjr#YUYn(=j;LW<9pwSDNWL4mbcqVLUHBn3|{N0@wU`!`CRhcT=l3s*Y`T9ISb> z(G71@L)P;Khetw#wN7x23w~zuv|vpdeqf%o^9NY`O4|MKZNQIBHX`G%OMbK>q)lQJ zOp~k65prE_%hyuCVBfIhn2t&B47BC8v?y`uou~XvOlT=>`PZ_g{#J=8Z%8Wfv+@1g zN}Iep&9KfU5K6r1hC(7v{Ge-e( z00_mhS&-+x!F;}C`}2ShAPzy3;`mxYudds!?d!37bsZ6DI-H?Tf-LfJjT#Mdx-R^$ z>m0KYJogIgg9SSPQ|s_!F){ua<6$7=GcY|`A@`1qePG^xVfv%$og-(~3ipPdet+tB z*|pPK{ZD_=e`K@&$SwYH|2O}b{iyKwiL>_x4{i-=w}x&NZ;zh6{lvK)MSikxo5;O= z+bJ@9=!+uBb-$h2%pUqUdsu`xWSTS+a1PY-o=d?eSzSjnz@K?tuX$F(!F5sB-)tC8 zbd%9_%QJOdm=ttH2AkAzz$+3vg!*HI{V+5f9*;1b&5H!*bB5$48 z1oNtK2957+S!@y;6)cmK2|0^-wJ;aq2LKL@&wCBWN(31W_p~b2Y}a%e z7SsXT6+A)>VILcJ6e^Usi5b<5riKNLf#>leVcD@Yl1_!TSY&J$fa{vH93@M%jP-zP zq2#EXI|x+jU4( zA4=y#Rb(~_M?tRRM*I#GMK}a0A*}U{uT$mQK*%w}u8^(gPlU2D_3R#dWV7RN6-rlx zbT$D8LBQufh9%OL{RsSoGzcs1Dj3oRA_#^h-+;1X%C7^0mdLX5I$4s+it*>& zND`hsnz(&bi_Cwi;lj#xsZ|bZEVx38S{nqM085O%IU72Sug3PSpqs24%&2u>KPf^x z5v?7q(OMPI0+2SeNs&e--*{{9n?sZEMj61J1U{tGQle6x79856lmnk6j=`S&6zGVa%{O-TQ$B{-(BtHqy|FJb(|W^oY!Uz z+rb_X1cB&C*Muv|3RPZ$K1DdV^A4^4Q%NC*Y!s?{zO1q_c=aHAmNvuMoJ$^&72pO4 z5M?6H*$YUTh6?XPi;1Cx693;|p9Fe-4yF~deIT7XxHT~R$-uGAfny)MxH)iQ?Ue`J zq-XHv@>=Q97hR-h=yRe1O=<8q<;~LJdxOVsPrQ6*@Rh$z-|o3^|H%Wt?B347{g=E5 z3~!W%$omH;l|M<7%K5U)o`JL0vr&_OC2Y_~wYdGia^>o%79L)`3g#h#8L|=IiB&nh z>lBS<*w2Q1`@&DPHt?7ZVIPxY?GZj=rI=i-%6T?|2hZYk1Sd>irdk9v6dP1CR zsV9IUP%lTj%lA|Ht&>04A%m$QJSsepVHJu&=CKPI+Eebwre(GP|4*Q42^+K0?rz$s znhZmMVIB?AeiQ#$iBB2!qoFZqTTsyHvPtWr2^X;ydR@3yI82y~{~kosA`IQnYcqH{zIPsXRhbHp*y*!R?>Hi{qLQDPp{;5(z5i#!+c4CMhT{eBV!W88%)9p{{vgi@u&a* literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/_core/_asyncio_selector_thread.py b/.venv/Lib/site-packages/anyio/_core/_asyncio_selector_thread.py new file mode 100644 index 0000000..9f35bae --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_asyncio_selector_thread.py @@ -0,0 +1,167 @@ +from __future__ import annotations + +import asyncio +import socket +import threading +from collections.abc import Callable +from selectors import EVENT_READ, EVENT_WRITE, DefaultSelector +from typing import TYPE_CHECKING, Any + +if TYPE_CHECKING: + from _typeshed import FileDescriptorLike + +_selector_lock = threading.Lock() +_selector: Selector | None = None + + +class Selector: + def __init__(self) -> None: + self._thread = threading.Thread(target=self.run, name="AnyIO socket selector") + self._selector = DefaultSelector() + self._send, self._receive = socket.socketpair() + self._send.setblocking(False) + self._receive.setblocking(False) + # This somewhat reduces the amount of memory wasted queueing up data + # for wakeups. With these settings, maximum number of 1-byte sends + # before getting BlockingIOError: + # Linux 4.8: 6 + # macOS (darwin 15.5): 1 + # Windows 10: 525347 + # Windows you're weird. (And on Windows setting SNDBUF to 0 makes send + # blocking, even on non-blocking sockets, so don't do that.) + self._receive.setsockopt(socket.SOL_SOCKET, socket.SO_RCVBUF, 1) + self._send.setsockopt(socket.SOL_SOCKET, socket.SO_SNDBUF, 1) + # On Windows this is a TCP socket so this might matter. On other + # platforms this fails b/c AF_UNIX sockets aren't actually TCP. + try: + self._send.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1) + except OSError: + pass + + self._selector.register(self._receive, EVENT_READ) + self._closed = False + + def start(self) -> None: + self._thread.start() + threading._register_atexit(self._stop) # type: ignore[attr-defined] + + def _stop(self) -> None: + global _selector + self._closed = True + self._notify_self() + self._send.close() + self._thread.join() + self._selector.unregister(self._receive) + self._receive.close() + self._selector.close() + _selector = None + assert not self._selector.get_map(), ( + "selector still has registered file descriptors after shutdown" + ) + + def _notify_self(self) -> None: + try: + self._send.send(b"\x00") + except BlockingIOError: + pass + + def add_reader(self, fd: FileDescriptorLike, callback: Callable[[], Any]) -> None: + loop = asyncio.get_running_loop() + try: + key = self._selector.get_key(fd) + except KeyError: + self._selector.register(fd, EVENT_READ, {EVENT_READ: (loop, callback)}) + else: + if EVENT_READ in key.data: + raise ValueError( + "this file descriptor is already registered for reading" + ) + + key.data[EVENT_READ] = loop, callback + self._selector.modify(fd, key.events | EVENT_READ, key.data) + + self._notify_self() + + def add_writer(self, fd: FileDescriptorLike, callback: Callable[[], Any]) -> None: + loop = asyncio.get_running_loop() + try: + key = self._selector.get_key(fd) + except KeyError: + self._selector.register(fd, EVENT_WRITE, {EVENT_WRITE: (loop, callback)}) + else: + if EVENT_WRITE in key.data: + raise ValueError( + "this file descriptor is already registered for writing" + ) + + key.data[EVENT_WRITE] = loop, callback + self._selector.modify(fd, key.events | EVENT_WRITE, key.data) + + self._notify_self() + + def remove_reader(self, fd: FileDescriptorLike) -> bool: + try: + key = self._selector.get_key(fd) + except KeyError: + return False + + if new_events := key.events ^ EVENT_READ: + del key.data[EVENT_READ] + self._selector.modify(fd, new_events, key.data) + else: + self._selector.unregister(fd) + + return True + + def remove_writer(self, fd: FileDescriptorLike) -> bool: + try: + key = self._selector.get_key(fd) + except KeyError: + return False + + if new_events := key.events ^ EVENT_WRITE: + del key.data[EVENT_WRITE] + self._selector.modify(fd, new_events, key.data) + else: + self._selector.unregister(fd) + + return True + + def run(self) -> None: + while not self._closed: + for key, events in self._selector.select(): + if key.fileobj is self._receive: + try: + while self._receive.recv(4096): + pass + except BlockingIOError: + pass + + continue + + if events & EVENT_READ: + loop, callback = key.data[EVENT_READ] + self.remove_reader(key.fd) + try: + loop.call_soon_threadsafe(callback) + except RuntimeError: + pass # the loop was already closed + + if events & EVENT_WRITE: + loop, callback = key.data[EVENT_WRITE] + self.remove_writer(key.fd) + try: + loop.call_soon_threadsafe(callback) + except RuntimeError: + pass # the loop was already closed + + +def get_selector() -> Selector: + global _selector + + with _selector_lock: + if _selector is None: + _selector = Selector() + _selector.start() + + return _selector diff --git a/.venv/Lib/site-packages/anyio/_core/_eventloop.py b/.venv/Lib/site-packages/anyio/_core/_eventloop.py new file mode 100644 index 0000000..6dcb458 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_eventloop.py @@ -0,0 +1,166 @@ +from __future__ import annotations + +import math +import sys +import threading +from collections.abc import Awaitable, Callable, Generator +from contextlib import contextmanager +from importlib import import_module +from typing import TYPE_CHECKING, Any, TypeVar + +import sniffio + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +if TYPE_CHECKING: + from ..abc import AsyncBackend + +# This must be updated when new backends are introduced +BACKENDS = "asyncio", "trio" + +T_Retval = TypeVar("T_Retval") +PosArgsT = TypeVarTuple("PosArgsT") + +threadlocals = threading.local() +loaded_backends: dict[str, type[AsyncBackend]] = {} + + +def run( + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + *args: Unpack[PosArgsT], + backend: str = "asyncio", + backend_options: dict[str, Any] | None = None, +) -> T_Retval: + """ + Run the given coroutine function in an asynchronous event loop. + + The current thread must not be already running an event loop. + + :param func: a coroutine function + :param args: positional arguments to ``func`` + :param backend: name of the asynchronous event loop implementation – currently + either ``asyncio`` or ``trio`` + :param backend_options: keyword arguments to call the backend ``run()`` + implementation with (documented :ref:`here `) + :return: the return value of the coroutine function + :raises RuntimeError: if an asynchronous event loop is already running in this + thread + :raises LookupError: if the named backend is not found + + """ + try: + asynclib_name = sniffio.current_async_library() + except sniffio.AsyncLibraryNotFoundError: + pass + else: + raise RuntimeError(f"Already running {asynclib_name} in this thread") + + try: + async_backend = get_async_backend(backend) + except ImportError as exc: + raise LookupError(f"No such backend: {backend}") from exc + + token = None + if sniffio.current_async_library_cvar.get(None) is None: + # Since we're in control of the event loop, we can cache the name of the async + # library + token = sniffio.current_async_library_cvar.set(backend) + + try: + backend_options = backend_options or {} + return async_backend.run(func, args, {}, backend_options) + finally: + if token: + sniffio.current_async_library_cvar.reset(token) + + +async def sleep(delay: float) -> None: + """ + Pause the current task for the specified duration. + + :param delay: the duration, in seconds + + """ + return await get_async_backend().sleep(delay) + + +async def sleep_forever() -> None: + """ + Pause the current task until it's cancelled. + + This is a shortcut for ``sleep(math.inf)``. + + .. versionadded:: 3.1 + + """ + await sleep(math.inf) + + +async def sleep_until(deadline: float) -> None: + """ + Pause the current task until the given time. + + :param deadline: the absolute time to wake up at (according to the internal + monotonic clock of the event loop) + + .. versionadded:: 3.1 + + """ + now = current_time() + await sleep(max(deadline - now, 0)) + + +def current_time() -> float: + """ + Return the current value of the event loop's internal clock. + + :return: the clock value (seconds) + + """ + return get_async_backend().current_time() + + +def get_all_backends() -> tuple[str, ...]: + """Return a tuple of the names of all built-in backends.""" + return BACKENDS + + +def get_cancelled_exc_class() -> type[BaseException]: + """Return the current async library's cancellation exception class.""" + return get_async_backend().cancelled_exception_class() + + +# +# Private API +# + + +@contextmanager +def claim_worker_thread( + backend_class: type[AsyncBackend], token: object +) -> Generator[Any, None, None]: + threadlocals.current_async_backend = backend_class + threadlocals.current_token = token + try: + yield + finally: + del threadlocals.current_async_backend + del threadlocals.current_token + + +def get_async_backend(asynclib_name: str | None = None) -> type[AsyncBackend]: + if asynclib_name is None: + asynclib_name = sniffio.current_async_library() + + # We use our own dict instead of sys.modules to get the already imported back-end + # class because the appropriate modules in sys.modules could potentially be only + # partially initialized + try: + return loaded_backends[asynclib_name] + except KeyError: + module = import_module(f"anyio._backends._{asynclib_name}") + loaded_backends[asynclib_name] = module.backend_class + return module.backend_class diff --git a/.venv/Lib/site-packages/anyio/_core/_exceptions.py b/.venv/Lib/site-packages/anyio/_core/_exceptions.py new file mode 100644 index 0000000..16b9448 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_exceptions.py @@ -0,0 +1,126 @@ +from __future__ import annotations + +import sys +from collections.abc import Generator +from textwrap import dedent +from typing import Any + +if sys.version_info < (3, 11): + from exceptiongroup import BaseExceptionGroup + + +class BrokenResourceError(Exception): + """ + Raised when trying to use a resource that has been rendered unusable due to external + causes (e.g. a send stream whose peer has disconnected). + """ + + +class BrokenWorkerProcess(Exception): + """ + Raised by :meth:`~anyio.to_process.run_sync` if the worker process terminates abruptly or + otherwise misbehaves. + """ + + +class BrokenWorkerIntepreter(Exception): + """ + Raised by :meth:`~anyio.to_interpreter.run_sync` if an unexpected exception is + raised in the subinterpreter. + """ + + def __init__(self, excinfo: Any): + # This was adapted from concurrent.futures.interpreter.ExecutionFailed + msg = excinfo.formatted + if not msg: + if excinfo.type and excinfo.msg: + msg = f"{excinfo.type.__name__}: {excinfo.msg}" + else: + msg = excinfo.type.__name__ or excinfo.msg + + super().__init__(msg) + self.excinfo = excinfo + + def __str__(self) -> str: + try: + formatted = self.excinfo.errdisplay + except Exception: + return super().__str__() + else: + return dedent( + f""" + {super().__str__()} + + Uncaught in the interpreter: + + {formatted} + """.strip() + ) + + +class BusyResourceError(Exception): + """ + Raised when two tasks are trying to read from or write to the same resource + concurrently. + """ + + def __init__(self, action: str): + super().__init__(f"Another task is already {action} this resource") + + +class ClosedResourceError(Exception): + """Raised when trying to use a resource that has been closed.""" + + +class DelimiterNotFound(Exception): + """ + Raised during + :meth:`~anyio.streams.buffered.BufferedByteReceiveStream.receive_until` if the + maximum number of bytes has been read without the delimiter being found. + """ + + def __init__(self, max_bytes: int) -> None: + super().__init__( + f"The delimiter was not found among the first {max_bytes} bytes" + ) + + +class EndOfStream(Exception): + """ + Raised when trying to read from a stream that has been closed from the other end. + """ + + +class IncompleteRead(Exception): + """ + Raised during + :meth:`~anyio.streams.buffered.BufferedByteReceiveStream.receive_exactly` or + :meth:`~anyio.streams.buffered.BufferedByteReceiveStream.receive_until` if the + connection is closed before the requested amount of bytes has been read. + """ + + def __init__(self) -> None: + super().__init__( + "The stream was closed before the read operation could be completed" + ) + + +class TypedAttributeLookupError(LookupError): + """ + Raised by :meth:`~anyio.TypedAttributeProvider.extra` when the given typed attribute + is not found and no default value has been given. + """ + + +class WouldBlock(Exception): + """Raised by ``X_nowait`` functions if ``X()`` would block.""" + + +def iterate_exceptions( + exception: BaseException, +) -> Generator[BaseException, None, None]: + if isinstance(exception, BaseExceptionGroup): + for exc in exception.exceptions: + yield from iterate_exceptions(exc) + else: + yield exception diff --git a/.venv/Lib/site-packages/anyio/_core/_fileio.py b/.venv/Lib/site-packages/anyio/_core/_fileio.py new file mode 100644 index 0000000..a0d6198 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_fileio.py @@ -0,0 +1,742 @@ +from __future__ import annotations + +import os +import pathlib +import sys +from collections.abc import ( + AsyncIterator, + Callable, + Iterable, + Iterator, + Sequence, +) +from dataclasses import dataclass +from functools import partial +from os import PathLike +from typing import ( + IO, + TYPE_CHECKING, + Any, + AnyStr, + ClassVar, + Final, + Generic, + overload, +) + +from .. import to_thread +from ..abc import AsyncResource + +if TYPE_CHECKING: + from types import ModuleType + + from _typeshed import OpenBinaryMode, OpenTextMode, ReadableBuffer, WriteableBuffer +else: + ReadableBuffer = OpenBinaryMode = OpenTextMode = WriteableBuffer = object + + +class AsyncFile(AsyncResource, Generic[AnyStr]): + """ + An asynchronous file object. + + This class wraps a standard file object and provides async friendly versions of the + following blocking methods (where available on the original file object): + + * read + * read1 + * readline + * readlines + * readinto + * readinto1 + * write + * writelines + * truncate + * seek + * tell + * flush + + All other methods are directly passed through. + + This class supports the asynchronous context manager protocol which closes the + underlying file at the end of the context block. + + This class also supports asynchronous iteration:: + + async with await open_file(...) as f: + async for line in f: + print(line) + """ + + def __init__(self, fp: IO[AnyStr]) -> None: + self._fp: Any = fp + + def __getattr__(self, name: str) -> object: + return getattr(self._fp, name) + + @property + def wrapped(self) -> IO[AnyStr]: + """The wrapped file object.""" + return self._fp + + async def __aiter__(self) -> AsyncIterator[AnyStr]: + while True: + line = await self.readline() + if line: + yield line + else: + break + + async def aclose(self) -> None: + return await to_thread.run_sync(self._fp.close) + + async def read(self, size: int = -1) -> AnyStr: + return await to_thread.run_sync(self._fp.read, size) + + async def read1(self: AsyncFile[bytes], size: int = -1) -> bytes: + return await to_thread.run_sync(self._fp.read1, size) + + async def readline(self) -> AnyStr: + return await to_thread.run_sync(self._fp.readline) + + async def readlines(self) -> list[AnyStr]: + return await to_thread.run_sync(self._fp.readlines) + + async def readinto(self: AsyncFile[bytes], b: WriteableBuffer) -> int: + return await to_thread.run_sync(self._fp.readinto, b) + + async def readinto1(self: AsyncFile[bytes], b: WriteableBuffer) -> int: + return await to_thread.run_sync(self._fp.readinto1, b) + + @overload + async def write(self: AsyncFile[bytes], b: ReadableBuffer) -> int: ... + + @overload + async def write(self: AsyncFile[str], b: str) -> int: ... + + async def write(self, b: ReadableBuffer | str) -> int: + return await to_thread.run_sync(self._fp.write, b) + + @overload + async def writelines( + self: AsyncFile[bytes], lines: Iterable[ReadableBuffer] + ) -> None: ... + + @overload + async def writelines(self: AsyncFile[str], lines: Iterable[str]) -> None: ... + + async def writelines(self, lines: Iterable[ReadableBuffer] | Iterable[str]) -> None: + return await to_thread.run_sync(self._fp.writelines, lines) + + async def truncate(self, size: int | None = None) -> int: + return await to_thread.run_sync(self._fp.truncate, size) + + async def seek(self, offset: int, whence: int | None = os.SEEK_SET) -> int: + return await to_thread.run_sync(self._fp.seek, offset, whence) + + async def tell(self) -> int: + return await to_thread.run_sync(self._fp.tell) + + async def flush(self) -> None: + return await to_thread.run_sync(self._fp.flush) + + +@overload +async def open_file( + file: str | PathLike[str] | int, + mode: OpenBinaryMode, + buffering: int = ..., + encoding: str | None = ..., + errors: str | None = ..., + newline: str | None = ..., + closefd: bool = ..., + opener: Callable[[str, int], int] | None = ..., +) -> AsyncFile[bytes]: ... + + +@overload +async def open_file( + file: str | PathLike[str] | int, + mode: OpenTextMode = ..., + buffering: int = ..., + encoding: str | None = ..., + errors: str | None = ..., + newline: str | None = ..., + closefd: bool = ..., + opener: Callable[[str, int], int] | None = ..., +) -> AsyncFile[str]: ... + + +async def open_file( + file: str | PathLike[str] | int, + mode: str = "r", + buffering: int = -1, + encoding: str | None = None, + errors: str | None = None, + newline: str | None = None, + closefd: bool = True, + opener: Callable[[str, int], int] | None = None, +) -> AsyncFile[Any]: + """ + Open a file asynchronously. + + The arguments are exactly the same as for the builtin :func:`open`. + + :return: an asynchronous file object + + """ + fp = await to_thread.run_sync( + open, file, mode, buffering, encoding, errors, newline, closefd, opener + ) + return AsyncFile(fp) + + +def wrap_file(file: IO[AnyStr]) -> AsyncFile[AnyStr]: + """ + Wrap an existing file as an asynchronous file. + + :param file: an existing file-like object + :return: an asynchronous file object + + """ + return AsyncFile(file) + + +@dataclass(eq=False) +class _PathIterator(AsyncIterator["Path"]): + iterator: Iterator[PathLike[str]] + + async def __anext__(self) -> Path: + nextval = await to_thread.run_sync( + next, self.iterator, None, abandon_on_cancel=True + ) + if nextval is None: + raise StopAsyncIteration from None + + return Path(nextval) + + +class Path: + """ + An asynchronous version of :class:`pathlib.Path`. + + This class cannot be substituted for :class:`pathlib.Path` or + :class:`pathlib.PurePath`, but it is compatible with the :class:`os.PathLike` + interface. + + It implements the Python 3.10 version of :class:`pathlib.Path` interface, except for + the deprecated :meth:`~pathlib.Path.link_to` method. + + Some methods may be unavailable or have limited functionality, based on the Python + version: + + * :meth:`~pathlib.Path.copy` (available on Python 3.14 or later) + * :meth:`~pathlib.Path.copy_into` (available on Python 3.14 or later) + * :meth:`~pathlib.Path.from_uri` (available on Python 3.13 or later) + * :meth:`~pathlib.PurePath.full_match` (available on Python 3.13 or later) + * :attr:`~pathlib.Path.info` (available on Python 3.14 or later) + * :meth:`~pathlib.Path.is_junction` (available on Python 3.12 or later) + * :meth:`~pathlib.PurePath.match` (the ``case_sensitive`` parameter is only + available on Python 3.13 or later) + * :meth:`~pathlib.Path.move` (available on Python 3.14 or later) + * :meth:`~pathlib.Path.move_into` (available on Python 3.14 or later) + * :meth:`~pathlib.PurePath.relative_to` (the ``walk_up`` parameter is only available + on Python 3.12 or later) + * :meth:`~pathlib.Path.walk` (available on Python 3.12 or later) + + Any methods that do disk I/O need to be awaited on. These methods are: + + * :meth:`~pathlib.Path.absolute` + * :meth:`~pathlib.Path.chmod` + * :meth:`~pathlib.Path.cwd` + * :meth:`~pathlib.Path.exists` + * :meth:`~pathlib.Path.expanduser` + * :meth:`~pathlib.Path.group` + * :meth:`~pathlib.Path.hardlink_to` + * :meth:`~pathlib.Path.home` + * :meth:`~pathlib.Path.is_block_device` + * :meth:`~pathlib.Path.is_char_device` + * :meth:`~pathlib.Path.is_dir` + * :meth:`~pathlib.Path.is_fifo` + * :meth:`~pathlib.Path.is_file` + * :meth:`~pathlib.Path.is_junction` + * :meth:`~pathlib.Path.is_mount` + * :meth:`~pathlib.Path.is_socket` + * :meth:`~pathlib.Path.is_symlink` + * :meth:`~pathlib.Path.lchmod` + * :meth:`~pathlib.Path.lstat` + * :meth:`~pathlib.Path.mkdir` + * :meth:`~pathlib.Path.open` + * :meth:`~pathlib.Path.owner` + * :meth:`~pathlib.Path.read_bytes` + * :meth:`~pathlib.Path.read_text` + * :meth:`~pathlib.Path.readlink` + * :meth:`~pathlib.Path.rename` + * :meth:`~pathlib.Path.replace` + * :meth:`~pathlib.Path.resolve` + * :meth:`~pathlib.Path.rmdir` + * :meth:`~pathlib.Path.samefile` + * :meth:`~pathlib.Path.stat` + * :meth:`~pathlib.Path.symlink_to` + * :meth:`~pathlib.Path.touch` + * :meth:`~pathlib.Path.unlink` + * :meth:`~pathlib.Path.walk` + * :meth:`~pathlib.Path.write_bytes` + * :meth:`~pathlib.Path.write_text` + + Additionally, the following methods return an async iterator yielding + :class:`~.Path` objects: + + * :meth:`~pathlib.Path.glob` + * :meth:`~pathlib.Path.iterdir` + * :meth:`~pathlib.Path.rglob` + """ + + __slots__ = "_path", "__weakref__" + + __weakref__: Any + + def __init__(self, *args: str | PathLike[str]) -> None: + self._path: Final[pathlib.Path] = pathlib.Path(*args) + + def __fspath__(self) -> str: + return self._path.__fspath__() + + def __str__(self) -> str: + return self._path.__str__() + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.as_posix()!r})" + + def __bytes__(self) -> bytes: + return self._path.__bytes__() + + def __hash__(self) -> int: + return self._path.__hash__() + + def __eq__(self, other: object) -> bool: + target = other._path if isinstance(other, Path) else other + return self._path.__eq__(target) + + def __lt__(self, other: pathlib.PurePath | Path) -> bool: + target = other._path if isinstance(other, Path) else other + return self._path.__lt__(target) + + def __le__(self, other: pathlib.PurePath | Path) -> bool: + target = other._path if isinstance(other, Path) else other + return self._path.__le__(target) + + def __gt__(self, other: pathlib.PurePath | Path) -> bool: + target = other._path if isinstance(other, Path) else other + return self._path.__gt__(target) + + def __ge__(self, other: pathlib.PurePath | Path) -> bool: + target = other._path if isinstance(other, Path) else other + return self._path.__ge__(target) + + def __truediv__(self, other: str | PathLike[str]) -> Path: + return Path(self._path / other) + + def __rtruediv__(self, other: str | PathLike[str]) -> Path: + return Path(other) / self + + @property + def parts(self) -> tuple[str, ...]: + return self._path.parts + + @property + def drive(self) -> str: + return self._path.drive + + @property + def root(self) -> str: + return self._path.root + + @property + def anchor(self) -> str: + return self._path.anchor + + @property + def parents(self) -> Sequence[Path]: + return tuple(Path(p) for p in self._path.parents) + + @property + def parent(self) -> Path: + return Path(self._path.parent) + + @property + def name(self) -> str: + return self._path.name + + @property + def suffix(self) -> str: + return self._path.suffix + + @property + def suffixes(self) -> list[str]: + return self._path.suffixes + + @property + def stem(self) -> str: + return self._path.stem + + async def absolute(self) -> Path: + path = await to_thread.run_sync(self._path.absolute) + return Path(path) + + def as_posix(self) -> str: + return self._path.as_posix() + + def as_uri(self) -> str: + return self._path.as_uri() + + if sys.version_info >= (3, 13): + parser: ClassVar[ModuleType] = pathlib.Path.parser + + @classmethod + def from_uri(cls, uri: str) -> Path: + return Path(pathlib.Path.from_uri(uri)) + + def full_match( + self, path_pattern: str, *, case_sensitive: bool | None = None + ) -> bool: + return self._path.full_match(path_pattern, case_sensitive=case_sensitive) + + def match( + self, path_pattern: str, *, case_sensitive: bool | None = None + ) -> bool: + return self._path.match(path_pattern, case_sensitive=case_sensitive) + else: + + def match(self, path_pattern: str) -> bool: + return self._path.match(path_pattern) + + if sys.version_info >= (3, 14): + + @property + def info(self) -> Any: # TODO: add return type annotation when Typeshed gets it + return self._path.info + + async def copy( + self, + target: str | os.PathLike[str], + *, + follow_symlinks: bool = True, + dirs_exist_ok: bool = False, + preserve_metadata: bool = False, + ) -> Path: + func = partial( + self._path.copy, + follow_symlinks=follow_symlinks, + dirs_exist_ok=dirs_exist_ok, + preserve_metadata=preserve_metadata, + ) + return Path(await to_thread.run_sync(func, target)) + + async def copy_into( + self, + target_dir: str | os.PathLike[str], + *, + follow_symlinks: bool = True, + dirs_exist_ok: bool = False, + preserve_metadata: bool = False, + ) -> Path: + func = partial( + self._path.copy_into, + follow_symlinks=follow_symlinks, + dirs_exist_ok=dirs_exist_ok, + preserve_metadata=preserve_metadata, + ) + return Path(await to_thread.run_sync(func, target_dir)) + + async def move(self, target: str | os.PathLike[str]) -> Path: + # Upstream does not handle anyio.Path properly as a PathLike + target = pathlib.Path(target) + return Path(await to_thread.run_sync(self._path.move, target)) + + async def move_into( + self, + target_dir: str | os.PathLike[str], + ) -> Path: + return Path(await to_thread.run_sync(self._path.move_into, target_dir)) + + def is_relative_to(self, other: str | PathLike[str]) -> bool: + try: + self.relative_to(other) + return True + except ValueError: + return False + + async def chmod(self, mode: int, *, follow_symlinks: bool = True) -> None: + func = partial(os.chmod, follow_symlinks=follow_symlinks) + return await to_thread.run_sync(func, self._path, mode) + + @classmethod + async def cwd(cls) -> Path: + path = await to_thread.run_sync(pathlib.Path.cwd) + return cls(path) + + async def exists(self) -> bool: + return await to_thread.run_sync(self._path.exists, abandon_on_cancel=True) + + async def expanduser(self) -> Path: + return Path( + await to_thread.run_sync(self._path.expanduser, abandon_on_cancel=True) + ) + + def glob(self, pattern: str) -> AsyncIterator[Path]: + gen = self._path.glob(pattern) + return _PathIterator(gen) + + async def group(self) -> str: + return await to_thread.run_sync(self._path.group, abandon_on_cancel=True) + + async def hardlink_to( + self, target: str | bytes | PathLike[str] | PathLike[bytes] + ) -> None: + if isinstance(target, Path): + target = target._path + + await to_thread.run_sync(os.link, target, self) + + @classmethod + async def home(cls) -> Path: + home_path = await to_thread.run_sync(pathlib.Path.home) + return cls(home_path) + + def is_absolute(self) -> bool: + return self._path.is_absolute() + + async def is_block_device(self) -> bool: + return await to_thread.run_sync( + self._path.is_block_device, abandon_on_cancel=True + ) + + async def is_char_device(self) -> bool: + return await to_thread.run_sync( + self._path.is_char_device, abandon_on_cancel=True + ) + + async def is_dir(self) -> bool: + return await to_thread.run_sync(self._path.is_dir, abandon_on_cancel=True) + + async def is_fifo(self) -> bool: + return await to_thread.run_sync(self._path.is_fifo, abandon_on_cancel=True) + + async def is_file(self) -> bool: + return await to_thread.run_sync(self._path.is_file, abandon_on_cancel=True) + + if sys.version_info >= (3, 12): + + async def is_junction(self) -> bool: + return await to_thread.run_sync(self._path.is_junction) + + async def is_mount(self) -> bool: + return await to_thread.run_sync( + os.path.ismount, self._path, abandon_on_cancel=True + ) + + def is_reserved(self) -> bool: + return self._path.is_reserved() + + async def is_socket(self) -> bool: + return await to_thread.run_sync(self._path.is_socket, abandon_on_cancel=True) + + async def is_symlink(self) -> bool: + return await to_thread.run_sync(self._path.is_symlink, abandon_on_cancel=True) + + async def iterdir(self) -> AsyncIterator[Path]: + gen = ( + self._path.iterdir() + if sys.version_info < (3, 13) + else await to_thread.run_sync(self._path.iterdir, abandon_on_cancel=True) + ) + async for path in _PathIterator(gen): + yield path + + def joinpath(self, *args: str | PathLike[str]) -> Path: + return Path(self._path.joinpath(*args)) + + async def lchmod(self, mode: int) -> None: + await to_thread.run_sync(self._path.lchmod, mode) + + async def lstat(self) -> os.stat_result: + return await to_thread.run_sync(self._path.lstat, abandon_on_cancel=True) + + async def mkdir( + self, mode: int = 0o777, parents: bool = False, exist_ok: bool = False + ) -> None: + await to_thread.run_sync(self._path.mkdir, mode, parents, exist_ok) + + @overload + async def open( + self, + mode: OpenBinaryMode, + buffering: int = ..., + encoding: str | None = ..., + errors: str | None = ..., + newline: str | None = ..., + ) -> AsyncFile[bytes]: ... + + @overload + async def open( + self, + mode: OpenTextMode = ..., + buffering: int = ..., + encoding: str | None = ..., + errors: str | None = ..., + newline: str | None = ..., + ) -> AsyncFile[str]: ... + + async def open( + self, + mode: str = "r", + buffering: int = -1, + encoding: str | None = None, + errors: str | None = None, + newline: str | None = None, + ) -> AsyncFile[Any]: + fp = await to_thread.run_sync( + self._path.open, mode, buffering, encoding, errors, newline + ) + return AsyncFile(fp) + + async def owner(self) -> str: + return await to_thread.run_sync(self._path.owner, abandon_on_cancel=True) + + async def read_bytes(self) -> bytes: + return await to_thread.run_sync(self._path.read_bytes) + + async def read_text( + self, encoding: str | None = None, errors: str | None = None + ) -> str: + return await to_thread.run_sync(self._path.read_text, encoding, errors) + + if sys.version_info >= (3, 12): + + def relative_to( + self, *other: str | PathLike[str], walk_up: bool = False + ) -> Path: + return Path(self._path.relative_to(*other, walk_up=walk_up)) + + else: + + def relative_to(self, *other: str | PathLike[str]) -> Path: + return Path(self._path.relative_to(*other)) + + async def readlink(self) -> Path: + target = await to_thread.run_sync(os.readlink, self._path) + return Path(target) + + async def rename(self, target: str | pathlib.PurePath | Path) -> Path: + if isinstance(target, Path): + target = target._path + + await to_thread.run_sync(self._path.rename, target) + return Path(target) + + async def replace(self, target: str | pathlib.PurePath | Path) -> Path: + if isinstance(target, Path): + target = target._path + + await to_thread.run_sync(self._path.replace, target) + return Path(target) + + async def resolve(self, strict: bool = False) -> Path: + func = partial(self._path.resolve, strict=strict) + return Path(await to_thread.run_sync(func, abandon_on_cancel=True)) + + def rglob(self, pattern: str) -> AsyncIterator[Path]: + gen = self._path.rglob(pattern) + return _PathIterator(gen) + + async def rmdir(self) -> None: + await to_thread.run_sync(self._path.rmdir) + + async def samefile(self, other_path: str | PathLike[str]) -> bool: + if isinstance(other_path, Path): + other_path = other_path._path + + return await to_thread.run_sync( + self._path.samefile, other_path, abandon_on_cancel=True + ) + + async def stat(self, *, follow_symlinks: bool = True) -> os.stat_result: + func = partial(os.stat, follow_symlinks=follow_symlinks) + return await to_thread.run_sync(func, self._path, abandon_on_cancel=True) + + async def symlink_to( + self, + target: str | bytes | PathLike[str] | PathLike[bytes], + target_is_directory: bool = False, + ) -> None: + if isinstance(target, Path): + target = target._path + + await to_thread.run_sync(self._path.symlink_to, target, target_is_directory) + + async def touch(self, mode: int = 0o666, exist_ok: bool = True) -> None: + await to_thread.run_sync(self._path.touch, mode, exist_ok) + + async def unlink(self, missing_ok: bool = False) -> None: + try: + await to_thread.run_sync(self._path.unlink) + except FileNotFoundError: + if not missing_ok: + raise + + if sys.version_info >= (3, 12): + + async def walk( + self, + top_down: bool = True, + on_error: Callable[[OSError], object] | None = None, + follow_symlinks: bool = False, + ) -> AsyncIterator[tuple[Path, list[str], list[str]]]: + def get_next_value() -> tuple[pathlib.Path, list[str], list[str]] | None: + try: + return next(gen) + except StopIteration: + return None + + gen = self._path.walk(top_down, on_error, follow_symlinks) + while True: + value = await to_thread.run_sync(get_next_value) + if value is None: + return + + root, dirs, paths = value + yield Path(root), dirs, paths + + def with_name(self, name: str) -> Path: + return Path(self._path.with_name(name)) + + def with_stem(self, stem: str) -> Path: + return Path(self._path.with_name(stem + self._path.suffix)) + + def with_suffix(self, suffix: str) -> Path: + return Path(self._path.with_suffix(suffix)) + + def with_segments(self, *pathsegments: str | PathLike[str]) -> Path: + return Path(*pathsegments) + + async def write_bytes(self, data: bytes) -> int: + return await to_thread.run_sync(self._path.write_bytes, data) + + async def write_text( + self, + data: str, + encoding: str | None = None, + errors: str | None = None, + newline: str | None = None, + ) -> int: + # Path.write_text() does not support the "newline" parameter before Python 3.10 + def sync_write_text() -> int: + with self._path.open( + "w", encoding=encoding, errors=errors, newline=newline + ) as fp: + return fp.write(data) + + return await to_thread.run_sync(sync_write_text) + + +PathLike.register(Path) diff --git a/.venv/Lib/site-packages/anyio/_core/_resources.py b/.venv/Lib/site-packages/anyio/_core/_resources.py new file mode 100644 index 0000000..b9a5344 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_resources.py @@ -0,0 +1,18 @@ +from __future__ import annotations + +from ..abc import AsyncResource +from ._tasks import CancelScope + + +async def aclose_forcefully(resource: AsyncResource) -> None: + """ + Close an asynchronous resource in a cancelled scope. + + Doing this closes the resource without waiting on anything. + + :param resource: the resource to close + + """ + with CancelScope() as scope: + scope.cancel() + await resource.aclose() diff --git a/.venv/Lib/site-packages/anyio/_core/_signals.py b/.venv/Lib/site-packages/anyio/_core/_signals.py new file mode 100644 index 0000000..f3451d3 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_signals.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +from collections.abc import AsyncIterator +from contextlib import AbstractContextManager +from signal import Signals + +from ._eventloop import get_async_backend + + +def open_signal_receiver( + *signals: Signals, +) -> AbstractContextManager[AsyncIterator[Signals]]: + """ + Start receiving operating system signals. + + :param signals: signals to receive (e.g. ``signal.SIGINT``) + :return: an asynchronous context manager for an asynchronous iterator which yields + signal numbers + + .. warning:: Windows does not support signals natively so it is best to avoid + relying on this in cross-platform applications. + + .. warning:: On asyncio, this permanently replaces any previous signal handler for + the given signals, as set via :meth:`~asyncio.loop.add_signal_handler`. + + """ + return get_async_backend().open_signal_receiver(*signals) diff --git a/.venv/Lib/site-packages/anyio/_core/_sockets.py b/.venv/Lib/site-packages/anyio/_core/_sockets.py new file mode 100644 index 0000000..054bcdd --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_sockets.py @@ -0,0 +1,792 @@ +from __future__ import annotations + +import errno +import os +import socket +import ssl +import stat +import sys +from collections.abc import Awaitable +from ipaddress import IPv6Address, ip_address +from os import PathLike, chmod +from socket import AddressFamily, SocketKind +from typing import TYPE_CHECKING, Any, Literal, cast, overload + +from .. import to_thread +from ..abc import ( + ConnectedUDPSocket, + ConnectedUNIXDatagramSocket, + IPAddressType, + IPSockAddrType, + SocketListener, + SocketStream, + UDPSocket, + UNIXDatagramSocket, + UNIXSocketStream, +) +from ..streams.stapled import MultiListener +from ..streams.tls import TLSStream +from ._eventloop import get_async_backend +from ._resources import aclose_forcefully +from ._synchronization import Event +from ._tasks import create_task_group, move_on_after + +if TYPE_CHECKING: + from _typeshed import FileDescriptorLike +else: + FileDescriptorLike = object + +if sys.version_info < (3, 11): + from exceptiongroup import ExceptionGroup + +if sys.version_info < (3, 13): + from typing_extensions import deprecated +else: + from warnings import deprecated + +IPPROTO_IPV6 = getattr(socket, "IPPROTO_IPV6", 41) # https://bugs.python.org/issue29515 + +AnyIPAddressFamily = Literal[ + AddressFamily.AF_UNSPEC, AddressFamily.AF_INET, AddressFamily.AF_INET6 +] +IPAddressFamily = Literal[AddressFamily.AF_INET, AddressFamily.AF_INET6] + + +# tls_hostname given +@overload +async def connect_tcp( + remote_host: IPAddressType, + remote_port: int, + *, + local_host: IPAddressType | None = ..., + ssl_context: ssl.SSLContext | None = ..., + tls_standard_compatible: bool = ..., + tls_hostname: str, + happy_eyeballs_delay: float = ..., +) -> TLSStream: ... + + +# ssl_context given +@overload +async def connect_tcp( + remote_host: IPAddressType, + remote_port: int, + *, + local_host: IPAddressType | None = ..., + ssl_context: ssl.SSLContext, + tls_standard_compatible: bool = ..., + tls_hostname: str | None = ..., + happy_eyeballs_delay: float = ..., +) -> TLSStream: ... + + +# tls=True +@overload +async def connect_tcp( + remote_host: IPAddressType, + remote_port: int, + *, + local_host: IPAddressType | None = ..., + tls: Literal[True], + ssl_context: ssl.SSLContext | None = ..., + tls_standard_compatible: bool = ..., + tls_hostname: str | None = ..., + happy_eyeballs_delay: float = ..., +) -> TLSStream: ... + + +# tls=False +@overload +async def connect_tcp( + remote_host: IPAddressType, + remote_port: int, + *, + local_host: IPAddressType | None = ..., + tls: Literal[False], + ssl_context: ssl.SSLContext | None = ..., + tls_standard_compatible: bool = ..., + tls_hostname: str | None = ..., + happy_eyeballs_delay: float = ..., +) -> SocketStream: ... + + +# No TLS arguments +@overload +async def connect_tcp( + remote_host: IPAddressType, + remote_port: int, + *, + local_host: IPAddressType | None = ..., + happy_eyeballs_delay: float = ..., +) -> SocketStream: ... + + +async def connect_tcp( + remote_host: IPAddressType, + remote_port: int, + *, + local_host: IPAddressType | None = None, + tls: bool = False, + ssl_context: ssl.SSLContext | None = None, + tls_standard_compatible: bool = True, + tls_hostname: str | None = None, + happy_eyeballs_delay: float = 0.25, +) -> SocketStream | TLSStream: + """ + Connect to a host using the TCP protocol. + + This function implements the stateless version of the Happy Eyeballs algorithm (RFC + 6555). If ``remote_host`` is a host name that resolves to multiple IP addresses, + each one is tried until one connection attempt succeeds. If the first attempt does + not connected within 250 milliseconds, a second attempt is started using the next + address in the list, and so on. On IPv6 enabled systems, an IPv6 address (if + available) is tried first. + + When the connection has been established, a TLS handshake will be done if either + ``ssl_context`` or ``tls_hostname`` is not ``None``, or if ``tls`` is ``True``. + + :param remote_host: the IP address or host name to connect to + :param remote_port: port on the target host to connect to + :param local_host: the interface address or name to bind the socket to before + connecting + :param tls: ``True`` to do a TLS handshake with the connected stream and return a + :class:`~anyio.streams.tls.TLSStream` instead + :param ssl_context: the SSL context object to use (if omitted, a default context is + created) + :param tls_standard_compatible: If ``True``, performs the TLS shutdown handshake + before closing the stream and requires that the server does this as well. + Otherwise, :exc:`~ssl.SSLEOFError` may be raised during reads from the stream. + Some protocols, such as HTTP, require this option to be ``False``. + See :meth:`~ssl.SSLContext.wrap_socket` for details. + :param tls_hostname: host name to check the server certificate against (defaults to + the value of ``remote_host``) + :param happy_eyeballs_delay: delay (in seconds) before starting the next connection + attempt + :return: a socket stream object if no TLS handshake was done, otherwise a TLS stream + :raises OSError: if the connection attempt fails + + """ + # Placed here due to https://github.com/python/mypy/issues/7057 + connected_stream: SocketStream | None = None + + async def try_connect(remote_host: str, event: Event) -> None: + nonlocal connected_stream + try: + stream = await asynclib.connect_tcp(remote_host, remote_port, local_address) + except OSError as exc: + oserrors.append(exc) + return + else: + if connected_stream is None: + connected_stream = stream + tg.cancel_scope.cancel() + else: + await stream.aclose() + finally: + event.set() + + asynclib = get_async_backend() + local_address: IPSockAddrType | None = None + family = socket.AF_UNSPEC + if local_host: + gai_res = await getaddrinfo(str(local_host), None) + family, *_, local_address = gai_res[0] + + target_host = str(remote_host) + try: + addr_obj = ip_address(remote_host) + except ValueError: + addr_obj = None + + if addr_obj is not None: + if isinstance(addr_obj, IPv6Address): + target_addrs = [(socket.AF_INET6, addr_obj.compressed)] + else: + target_addrs = [(socket.AF_INET, addr_obj.compressed)] + else: + # getaddrinfo() will raise an exception if name resolution fails + gai_res = await getaddrinfo( + target_host, remote_port, family=family, type=socket.SOCK_STREAM + ) + + # Organize the list so that the first address is an IPv6 address (if available) + # and the second one is an IPv4 addresses. The rest can be in whatever order. + v6_found = v4_found = False + target_addrs = [] + for af, *rest, sa in gai_res: + if af == socket.AF_INET6 and not v6_found: + v6_found = True + target_addrs.insert(0, (af, sa[0])) + elif af == socket.AF_INET and not v4_found and v6_found: + v4_found = True + target_addrs.insert(1, (af, sa[0])) + else: + target_addrs.append((af, sa[0])) + + oserrors: list[OSError] = [] + try: + async with create_task_group() as tg: + for i, (af, addr) in enumerate(target_addrs): + event = Event() + tg.start_soon(try_connect, addr, event) + with move_on_after(happy_eyeballs_delay): + await event.wait() + + if connected_stream is None: + cause = ( + oserrors[0] + if len(oserrors) == 1 + else ExceptionGroup("multiple connection attempts failed", oserrors) + ) + raise OSError("All connection attempts failed") from cause + finally: + oserrors.clear() + + if tls or tls_hostname or ssl_context: + try: + return await TLSStream.wrap( + connected_stream, + server_side=False, + hostname=tls_hostname or str(remote_host), + ssl_context=ssl_context, + standard_compatible=tls_standard_compatible, + ) + except BaseException: + await aclose_forcefully(connected_stream) + raise + + return connected_stream + + +async def connect_unix(path: str | bytes | PathLike[Any]) -> UNIXSocketStream: + """ + Connect to the given UNIX socket. + + Not available on Windows. + + :param path: path to the socket + :return: a socket stream object + + """ + path = os.fspath(path) + return await get_async_backend().connect_unix(path) + + +async def create_tcp_listener( + *, + local_host: IPAddressType | None = None, + local_port: int = 0, + family: AnyIPAddressFamily = socket.AddressFamily.AF_UNSPEC, + backlog: int = 65536, + reuse_port: bool = False, +) -> MultiListener[SocketStream]: + """ + Create a TCP socket listener. + + :param local_port: port number to listen on + :param local_host: IP address of the interface to listen on. If omitted, listen on + all IPv4 and IPv6 interfaces. To listen on all interfaces on a specific address + family, use ``0.0.0.0`` for IPv4 or ``::`` for IPv6. + :param family: address family (used if ``local_host`` was omitted) + :param backlog: maximum number of queued incoming connections (up to a maximum of + 2**16, or 65536) + :param reuse_port: ``True`` to allow multiple sockets to bind to the same + address/port (not supported on Windows) + :return: a list of listener objects + + """ + asynclib = get_async_backend() + backlog = min(backlog, 65536) + local_host = str(local_host) if local_host is not None else None + gai_res = await getaddrinfo( + local_host, + local_port, + family=family, + type=socket.SocketKind.SOCK_STREAM if sys.platform == "win32" else 0, + flags=socket.AI_PASSIVE | socket.AI_ADDRCONFIG, + ) + listeners: list[SocketListener] = [] + try: + # The set() is here to work around a glibc bug: + # https://sourceware.org/bugzilla/show_bug.cgi?id=14969 + sockaddr: tuple[str, int] | tuple[str, int, int, int] + for fam, kind, *_, sockaddr in sorted(set(gai_res)): + # Workaround for an uvloop bug where we don't get the correct scope ID for + # IPv6 link-local addresses when passing type=socket.SOCK_STREAM to + # getaddrinfo(): https://github.com/MagicStack/uvloop/issues/539 + if sys.platform != "win32" and kind is not SocketKind.SOCK_STREAM: + continue + + raw_socket = socket.socket(fam) + raw_socket.setblocking(False) + + # For Windows, enable exclusive address use. For others, enable address + # reuse. + if sys.platform == "win32": + raw_socket.setsockopt(socket.SOL_SOCKET, socket.SO_EXCLUSIVEADDRUSE, 1) + else: + raw_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) + + if reuse_port: + raw_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1) + + # If only IPv6 was requested, disable dual stack operation + if fam == socket.AF_INET6: + raw_socket.setsockopt(IPPROTO_IPV6, socket.IPV6_V6ONLY, 1) + + # Workaround for #554 + if "%" in sockaddr[0]: + addr, scope_id = sockaddr[0].split("%", 1) + sockaddr = (addr, sockaddr[1], 0, int(scope_id)) + + raw_socket.bind(sockaddr) + raw_socket.listen(backlog) + listener = asynclib.create_tcp_listener(raw_socket) + listeners.append(listener) + except BaseException: + for listener in listeners: + await listener.aclose() + + raise + + return MultiListener(listeners) + + +async def create_unix_listener( + path: str | bytes | PathLike[Any], + *, + mode: int | None = None, + backlog: int = 65536, +) -> SocketListener: + """ + Create a UNIX socket listener. + + Not available on Windows. + + :param path: path of the socket + :param mode: permissions to set on the socket + :param backlog: maximum number of queued incoming connections (up to a maximum of + 2**16, or 65536) + :return: a listener object + + .. versionchanged:: 3.0 + If a socket already exists on the file system in the given path, it will be + removed first. + + """ + backlog = min(backlog, 65536) + raw_socket = await setup_unix_local_socket(path, mode, socket.SOCK_STREAM) + try: + raw_socket.listen(backlog) + return get_async_backend().create_unix_listener(raw_socket) + except BaseException: + raw_socket.close() + raise + + +async def create_udp_socket( + family: AnyIPAddressFamily = AddressFamily.AF_UNSPEC, + *, + local_host: IPAddressType | None = None, + local_port: int = 0, + reuse_port: bool = False, +) -> UDPSocket: + """ + Create a UDP socket. + + If ``port`` has been given, the socket will be bound to this port on the local + machine, making this socket suitable for providing UDP based services. + + :param family: address family (``AF_INET`` or ``AF_INET6``) – automatically + determined from ``local_host`` if omitted + :param local_host: IP address or host name of the local interface to bind to + :param local_port: local port to bind to + :param reuse_port: ``True`` to allow multiple sockets to bind to the same + address/port (not supported on Windows) + :return: a UDP socket + + """ + if family is AddressFamily.AF_UNSPEC and not local_host: + raise ValueError('Either "family" or "local_host" must be given') + + if local_host: + gai_res = await getaddrinfo( + str(local_host), + local_port, + family=family, + type=socket.SOCK_DGRAM, + flags=socket.AI_PASSIVE | socket.AI_ADDRCONFIG, + ) + family = cast(AnyIPAddressFamily, gai_res[0][0]) + local_address = gai_res[0][-1] + elif family is AddressFamily.AF_INET6: + local_address = ("::", 0) + else: + local_address = ("0.0.0.0", 0) + + sock = await get_async_backend().create_udp_socket( + family, local_address, None, reuse_port + ) + return cast(UDPSocket, sock) + + +async def create_connected_udp_socket( + remote_host: IPAddressType, + remote_port: int, + *, + family: AnyIPAddressFamily = AddressFamily.AF_UNSPEC, + local_host: IPAddressType | None = None, + local_port: int = 0, + reuse_port: bool = False, +) -> ConnectedUDPSocket: + """ + Create a connected UDP socket. + + Connected UDP sockets can only communicate with the specified remote host/port, an + any packets sent from other sources are dropped. + + :param remote_host: remote host to set as the default target + :param remote_port: port on the remote host to set as the default target + :param family: address family (``AF_INET`` or ``AF_INET6``) – automatically + determined from ``local_host`` or ``remote_host`` if omitted + :param local_host: IP address or host name of the local interface to bind to + :param local_port: local port to bind to + :param reuse_port: ``True`` to allow multiple sockets to bind to the same + address/port (not supported on Windows) + :return: a connected UDP socket + + """ + local_address = None + if local_host: + gai_res = await getaddrinfo( + str(local_host), + local_port, + family=family, + type=socket.SOCK_DGRAM, + flags=socket.AI_PASSIVE | socket.AI_ADDRCONFIG, + ) + family = cast(AnyIPAddressFamily, gai_res[0][0]) + local_address = gai_res[0][-1] + + gai_res = await getaddrinfo( + str(remote_host), remote_port, family=family, type=socket.SOCK_DGRAM + ) + family = cast(AnyIPAddressFamily, gai_res[0][0]) + remote_address = gai_res[0][-1] + + sock = await get_async_backend().create_udp_socket( + family, local_address, remote_address, reuse_port + ) + return cast(ConnectedUDPSocket, sock) + + +async def create_unix_datagram_socket( + *, + local_path: None | str | bytes | PathLike[Any] = None, + local_mode: int | None = None, +) -> UNIXDatagramSocket: + """ + Create a UNIX datagram socket. + + Not available on Windows. + + If ``local_path`` has been given, the socket will be bound to this path, making this + socket suitable for receiving datagrams from other processes. Other processes can + send datagrams to this socket only if ``local_path`` is set. + + If a socket already exists on the file system in the ``local_path``, it will be + removed first. + + :param local_path: the path on which to bind to + :param local_mode: permissions to set on the local socket + :return: a UNIX datagram socket + + """ + raw_socket = await setup_unix_local_socket( + local_path, local_mode, socket.SOCK_DGRAM + ) + return await get_async_backend().create_unix_datagram_socket(raw_socket, None) + + +async def create_connected_unix_datagram_socket( + remote_path: str | bytes | PathLike[Any], + *, + local_path: None | str | bytes | PathLike[Any] = None, + local_mode: int | None = None, +) -> ConnectedUNIXDatagramSocket: + """ + Create a connected UNIX datagram socket. + + Connected datagram sockets can only communicate with the specified remote path. + + If ``local_path`` has been given, the socket will be bound to this path, making + this socket suitable for receiving datagrams from other processes. Other processes + can send datagrams to this socket only if ``local_path`` is set. + + If a socket already exists on the file system in the ``local_path``, it will be + removed first. + + :param remote_path: the path to set as the default target + :param local_path: the path on which to bind to + :param local_mode: permissions to set on the local socket + :return: a connected UNIX datagram socket + + """ + remote_path = os.fspath(remote_path) + raw_socket = await setup_unix_local_socket( + local_path, local_mode, socket.SOCK_DGRAM + ) + return await get_async_backend().create_unix_datagram_socket( + raw_socket, remote_path + ) + + +async def getaddrinfo( + host: bytes | str | None, + port: str | int | None, + *, + family: int | AddressFamily = 0, + type: int | SocketKind = 0, + proto: int = 0, + flags: int = 0, +) -> list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int]]]: + """ + Look up a numeric IP address given a host name. + + Internationalized domain names are translated according to the (non-transitional) + IDNA 2008 standard. + + .. note:: 4-tuple IPv6 socket addresses are automatically converted to 2-tuples of + (host, port), unlike what :func:`socket.getaddrinfo` does. + + :param host: host name + :param port: port number + :param family: socket family (`'AF_INET``, ...) + :param type: socket type (``SOCK_STREAM``, ...) + :param proto: protocol number + :param flags: flags to pass to upstream ``getaddrinfo()`` + :return: list of tuples containing (family, type, proto, canonname, sockaddr) + + .. seealso:: :func:`socket.getaddrinfo` + + """ + # Handle unicode hostnames + if isinstance(host, str): + try: + encoded_host: bytes | None = host.encode("ascii") + except UnicodeEncodeError: + import idna + + encoded_host = idna.encode(host, uts46=True) + else: + encoded_host = host + + gai_res = await get_async_backend().getaddrinfo( + encoded_host, port, family=family, type=type, proto=proto, flags=flags + ) + return [ + (family, type, proto, canonname, convert_ipv6_sockaddr(sockaddr)) + for family, type, proto, canonname, sockaddr in gai_res + # filter out IPv6 results when IPv6 is disabled + if not isinstance(sockaddr[0], int) + ] + + +def getnameinfo(sockaddr: IPSockAddrType, flags: int = 0) -> Awaitable[tuple[str, str]]: + """ + Look up the host name of an IP address. + + :param sockaddr: socket address (e.g. (ipaddress, port) for IPv4) + :param flags: flags to pass to upstream ``getnameinfo()`` + :return: a tuple of (host name, service name) + + .. seealso:: :func:`socket.getnameinfo` + + """ + return get_async_backend().getnameinfo(sockaddr, flags) + + +@deprecated("This function is deprecated; use `wait_readable` instead") +def wait_socket_readable(sock: socket.socket) -> Awaitable[None]: + """ + .. deprecated:: 4.7.0 + Use :func:`wait_readable` instead. + + Wait until the given socket has data to be read. + + .. warning:: Only use this on raw sockets that have not been wrapped by any higher + level constructs like socket streams! + + :param sock: a socket object + :raises ~anyio.ClosedResourceError: if the socket was closed while waiting for the + socket to become readable + :raises ~anyio.BusyResourceError: if another task is already waiting for the socket + to become readable + + """ + return get_async_backend().wait_readable(sock.fileno()) + + +@deprecated("This function is deprecated; use `wait_writable` instead") +def wait_socket_writable(sock: socket.socket) -> Awaitable[None]: + """ + .. deprecated:: 4.7.0 + Use :func:`wait_writable` instead. + + Wait until the given socket can be written to. + + This does **NOT** work on Windows when using the asyncio backend with a proactor + event loop (default on py3.8+). + + .. warning:: Only use this on raw sockets that have not been wrapped by any higher + level constructs like socket streams! + + :param sock: a socket object + :raises ~anyio.ClosedResourceError: if the socket was closed while waiting for the + socket to become writable + :raises ~anyio.BusyResourceError: if another task is already waiting for the socket + to become writable + + """ + return get_async_backend().wait_writable(sock.fileno()) + + +def wait_readable(obj: FileDescriptorLike) -> Awaitable[None]: + """ + Wait until the given object has data to be read. + + On Unix systems, ``obj`` must either be an integer file descriptor, or else an + object with a ``.fileno()`` method which returns an integer file descriptor. Any + kind of file descriptor can be passed, though the exact semantics will depend on + your kernel. For example, this probably won't do anything useful for on-disk files. + + On Windows systems, ``obj`` must either be an integer ``SOCKET`` handle, or else an + object with a ``.fileno()`` method which returns an integer ``SOCKET`` handle. File + descriptors aren't supported, and neither are handles that refer to anything besides + a ``SOCKET``. + + On backends where this functionality is not natively provided (asyncio + ``ProactorEventLoop`` on Windows), it is provided using a separate selector thread + which is set to shut down when the interpreter shuts down. + + .. warning:: Don't use this on raw sockets that have been wrapped by any higher + level constructs like socket streams! + + :param obj: an object with a ``.fileno()`` method or an integer handle + :raises ~anyio.ClosedResourceError: if the object was closed while waiting for the + object to become readable + :raises ~anyio.BusyResourceError: if another task is already waiting for the object + to become readable + + """ + return get_async_backend().wait_readable(obj) + + +def wait_writable(obj: FileDescriptorLike) -> Awaitable[None]: + """ + Wait until the given object can be written to. + + :param obj: an object with a ``.fileno()`` method or an integer handle + :raises ~anyio.ClosedResourceError: if the object was closed while waiting for the + object to become writable + :raises ~anyio.BusyResourceError: if another task is already waiting for the object + to become writable + + .. seealso:: See the documentation of :func:`wait_readable` for the definition of + ``obj`` and notes on backend compatibility. + + .. warning:: Don't use this on raw sockets that have been wrapped by any higher + level constructs like socket streams! + + """ + return get_async_backend().wait_writable(obj) + + +# +# Private API +# + + +def convert_ipv6_sockaddr( + sockaddr: tuple[str, int, int, int] | tuple[str, int], +) -> tuple[str, int]: + """ + Convert a 4-tuple IPv6 socket address to a 2-tuple (address, port) format. + + If the scope ID is nonzero, it is added to the address, separated with ``%``. + Otherwise the flow id and scope id are simply cut off from the tuple. + Any other kinds of socket addresses are returned as-is. + + :param sockaddr: the result of :meth:`~socket.socket.getsockname` + :return: the converted socket address + + """ + # This is more complicated than it should be because of MyPy + if isinstance(sockaddr, tuple) and len(sockaddr) == 4: + host, port, flowinfo, scope_id = sockaddr + if scope_id: + # PyPy (as of v7.3.11) leaves the interface name in the result, so + # we discard it and only get the scope ID from the end + # (https://foss.heptapod.net/pypy/pypy/-/issues/3938) + host = host.split("%")[0] + + # Add scope_id to the address + return f"{host}%{scope_id}", port + else: + return host, port + else: + return sockaddr + + +async def setup_unix_local_socket( + path: None | str | bytes | PathLike[Any], + mode: int | None, + socktype: int, +) -> socket.socket: + """ + Create a UNIX local socket object, deleting the socket at the given path if it + exists. + + Not available on Windows. + + :param path: path of the socket + :param mode: permissions to set on the socket + :param socktype: socket.SOCK_STREAM or socket.SOCK_DGRAM + + """ + path_str: str | None + if path is not None: + path_str = os.fsdecode(path) + + # Linux abstract namespace sockets aren't backed by a concrete file so skip stat call + if not path_str.startswith("\0"): + # Copied from pathlib... + try: + stat_result = os.stat(path) + except OSError as e: + if e.errno not in ( + errno.ENOENT, + errno.ENOTDIR, + errno.EBADF, + errno.ELOOP, + ): + raise + else: + if stat.S_ISSOCK(stat_result.st_mode): + os.unlink(path) + else: + path_str = None + + raw_socket = socket.socket(socket.AF_UNIX, socktype) + raw_socket.setblocking(False) + + if path_str is not None: + try: + await to_thread.run_sync(raw_socket.bind, path_str, abandon_on_cancel=True) + if mode is not None: + await to_thread.run_sync(chmod, path_str, mode, abandon_on_cancel=True) + except BaseException: + raw_socket.close() + raise + + return raw_socket diff --git a/.venv/Lib/site-packages/anyio/_core/_streams.py b/.venv/Lib/site-packages/anyio/_core/_streams.py new file mode 100644 index 0000000..6a9814e --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_streams.py @@ -0,0 +1,52 @@ +from __future__ import annotations + +import math +from typing import TypeVar +from warnings import warn + +from ..streams.memory import ( + MemoryObjectReceiveStream, + MemoryObjectSendStream, + MemoryObjectStreamState, +) + +T_Item = TypeVar("T_Item") + + +class create_memory_object_stream( + tuple[MemoryObjectSendStream[T_Item], MemoryObjectReceiveStream[T_Item]], +): + """ + Create a memory object stream. + + The stream's item type can be annotated like + :func:`create_memory_object_stream[T_Item]`. + + :param max_buffer_size: number of items held in the buffer until ``send()`` starts + blocking + :param item_type: old way of marking the streams with the right generic type for + static typing (does nothing on AnyIO 4) + + .. deprecated:: 4.0 + Use ``create_memory_object_stream[YourItemType](...)`` instead. + :return: a tuple of (send stream, receive stream) + + """ + + def __new__( # type: ignore[misc] + cls, max_buffer_size: float = 0, item_type: object = None + ) -> tuple[MemoryObjectSendStream[T_Item], MemoryObjectReceiveStream[T_Item]]: + if max_buffer_size != math.inf and not isinstance(max_buffer_size, int): + raise ValueError("max_buffer_size must be either an integer or math.inf") + if max_buffer_size < 0: + raise ValueError("max_buffer_size cannot be negative") + if item_type is not None: + warn( + "The item_type argument has been deprecated in AnyIO 4.0. " + "Use create_memory_object_stream[YourItemType](...) instead.", + DeprecationWarning, + stacklevel=2, + ) + + state = MemoryObjectStreamState[T_Item](max_buffer_size) + return (MemoryObjectSendStream(state), MemoryObjectReceiveStream(state)) diff --git a/.venv/Lib/site-packages/anyio/_core/_subprocesses.py b/.venv/Lib/site-packages/anyio/_core/_subprocesses.py new file mode 100644 index 0000000..36d9b30 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_subprocesses.py @@ -0,0 +1,202 @@ +from __future__ import annotations + +import sys +from collections.abc import AsyncIterable, Iterable, Mapping, Sequence +from io import BytesIO +from os import PathLike +from subprocess import PIPE, CalledProcessError, CompletedProcess +from typing import IO, Any, Union, cast + +from ..abc import Process +from ._eventloop import get_async_backend +from ._tasks import create_task_group + +if sys.version_info >= (3, 10): + from typing import TypeAlias +else: + from typing_extensions import TypeAlias + +StrOrBytesPath: TypeAlias = Union[str, bytes, "PathLike[str]", "PathLike[bytes]"] + + +async def run_process( + command: StrOrBytesPath | Sequence[StrOrBytesPath], + *, + input: bytes | None = None, + stdin: int | IO[Any] | None = None, + stdout: int | IO[Any] | None = PIPE, + stderr: int | IO[Any] | None = PIPE, + check: bool = True, + cwd: StrOrBytesPath | None = None, + env: Mapping[str, str] | None = None, + startupinfo: Any = None, + creationflags: int = 0, + start_new_session: bool = False, + pass_fds: Sequence[int] = (), + user: str | int | None = None, + group: str | int | None = None, + extra_groups: Iterable[str | int] | None = None, + umask: int = -1, +) -> CompletedProcess[bytes]: + """ + Run an external command in a subprocess and wait until it completes. + + .. seealso:: :func:`subprocess.run` + + :param command: either a string to pass to the shell, or an iterable of strings + containing the executable name or path and its arguments + :param input: bytes passed to the standard input of the subprocess + :param stdin: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, + a file-like object, or `None`; ``input`` overrides this + :param stdout: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, + a file-like object, or `None` + :param stderr: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, + :data:`subprocess.STDOUT`, a file-like object, or `None` + :param check: if ``True``, raise :exc:`~subprocess.CalledProcessError` if the + process terminates with a return code other than 0 + :param cwd: If not ``None``, change the working directory to this before running the + command + :param env: if not ``None``, this mapping replaces the inherited environment + variables from the parent process + :param startupinfo: an instance of :class:`subprocess.STARTUPINFO` that can be used + to specify process startup parameters (Windows only) + :param creationflags: flags that can be used to control the creation of the + subprocess (see :class:`subprocess.Popen` for the specifics) + :param start_new_session: if ``true`` the setsid() system call will be made in the + child process prior to the execution of the subprocess. (POSIX only) + :param pass_fds: sequence of file descriptors to keep open between the parent and + child processes. (POSIX only) + :param user: effective user to run the process as (Python >= 3.9, POSIX only) + :param group: effective group to run the process as (Python >= 3.9, POSIX only) + :param extra_groups: supplementary groups to set in the subprocess (Python >= 3.9, + POSIX only) + :param umask: if not negative, this umask is applied in the child process before + running the given command (Python >= 3.9, POSIX only) + :return: an object representing the completed process + :raises ~subprocess.CalledProcessError: if ``check`` is ``True`` and the process + exits with a nonzero return code + + """ + + async def drain_stream(stream: AsyncIterable[bytes], index: int) -> None: + buffer = BytesIO() + async for chunk in stream: + buffer.write(chunk) + + stream_contents[index] = buffer.getvalue() + + if stdin is not None and input is not None: + raise ValueError("only one of stdin and input is allowed") + + async with await open_process( + command, + stdin=PIPE if input else stdin, + stdout=stdout, + stderr=stderr, + cwd=cwd, + env=env, + startupinfo=startupinfo, + creationflags=creationflags, + start_new_session=start_new_session, + pass_fds=pass_fds, + user=user, + group=group, + extra_groups=extra_groups, + umask=umask, + ) as process: + stream_contents: list[bytes | None] = [None, None] + async with create_task_group() as tg: + if process.stdout: + tg.start_soon(drain_stream, process.stdout, 0) + + if process.stderr: + tg.start_soon(drain_stream, process.stderr, 1) + + if process.stdin and input: + await process.stdin.send(input) + await process.stdin.aclose() + + await process.wait() + + output, errors = stream_contents + if check and process.returncode != 0: + raise CalledProcessError(cast(int, process.returncode), command, output, errors) + + return CompletedProcess(command, cast(int, process.returncode), output, errors) + + +async def open_process( + command: StrOrBytesPath | Sequence[StrOrBytesPath], + *, + stdin: int | IO[Any] | None = PIPE, + stdout: int | IO[Any] | None = PIPE, + stderr: int | IO[Any] | None = PIPE, + cwd: StrOrBytesPath | None = None, + env: Mapping[str, str] | None = None, + startupinfo: Any = None, + creationflags: int = 0, + start_new_session: bool = False, + pass_fds: Sequence[int] = (), + user: str | int | None = None, + group: str | int | None = None, + extra_groups: Iterable[str | int] | None = None, + umask: int = -1, +) -> Process: + """ + Start an external command in a subprocess. + + .. seealso:: :class:`subprocess.Popen` + + :param command: either a string to pass to the shell, or an iterable of strings + containing the executable name or path and its arguments + :param stdin: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, a + file-like object, or ``None`` + :param stdout: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, + a file-like object, or ``None`` + :param stderr: one of :data:`subprocess.PIPE`, :data:`subprocess.DEVNULL`, + :data:`subprocess.STDOUT`, a file-like object, or ``None`` + :param cwd: If not ``None``, the working directory is changed before executing + :param env: If env is not ``None``, it must be a mapping that defines the + environment variables for the new process + :param creationflags: flags that can be used to control the creation of the + subprocess (see :class:`subprocess.Popen` for the specifics) + :param startupinfo: an instance of :class:`subprocess.STARTUPINFO` that can be used + to specify process startup parameters (Windows only) + :param start_new_session: if ``true`` the setsid() system call will be made in the + child process prior to the execution of the subprocess. (POSIX only) + :param pass_fds: sequence of file descriptors to keep open between the parent and + child processes. (POSIX only) + :param user: effective user to run the process as (POSIX only) + :param group: effective group to run the process as (POSIX only) + :param extra_groups: supplementary groups to set in the subprocess (POSIX only) + :param umask: if not negative, this umask is applied in the child process before + running the given command (POSIX only) + :return: an asynchronous process object + + """ + kwargs: dict[str, Any] = {} + if user is not None: + kwargs["user"] = user + + if group is not None: + kwargs["group"] = group + + if extra_groups is not None: + kwargs["extra_groups"] = group + + if umask >= 0: + kwargs["umask"] = umask + + return await get_async_backend().open_process( + command, + stdin=stdin, + stdout=stdout, + stderr=stderr, + cwd=cwd, + env=env, + startupinfo=startupinfo, + creationflags=creationflags, + start_new_session=start_new_session, + pass_fds=pass_fds, + **kwargs, + ) diff --git a/.venv/Lib/site-packages/anyio/_core/_synchronization.py b/.venv/Lib/site-packages/anyio/_core/_synchronization.py new file mode 100644 index 0000000..a633132 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_synchronization.py @@ -0,0 +1,732 @@ +from __future__ import annotations + +import math +from collections import deque +from dataclasses import dataclass +from types import TracebackType + +from sniffio import AsyncLibraryNotFoundError + +from ..lowlevel import checkpoint +from ._eventloop import get_async_backend +from ._exceptions import BusyResourceError +from ._tasks import CancelScope +from ._testing import TaskInfo, get_current_task + + +@dataclass(frozen=True) +class EventStatistics: + """ + :ivar int tasks_waiting: number of tasks waiting on :meth:`~.Event.wait` + """ + + tasks_waiting: int + + +@dataclass(frozen=True) +class CapacityLimiterStatistics: + """ + :ivar int borrowed_tokens: number of tokens currently borrowed by tasks + :ivar float total_tokens: total number of available tokens + :ivar tuple borrowers: tasks or other objects currently holding tokens borrowed from + this limiter + :ivar int tasks_waiting: number of tasks waiting on + :meth:`~.CapacityLimiter.acquire` or + :meth:`~.CapacityLimiter.acquire_on_behalf_of` + """ + + borrowed_tokens: int + total_tokens: float + borrowers: tuple[object, ...] + tasks_waiting: int + + +@dataclass(frozen=True) +class LockStatistics: + """ + :ivar bool locked: flag indicating if this lock is locked or not + :ivar ~anyio.TaskInfo owner: task currently holding the lock (or ``None`` if the + lock is not held by any task) + :ivar int tasks_waiting: number of tasks waiting on :meth:`~.Lock.acquire` + """ + + locked: bool + owner: TaskInfo | None + tasks_waiting: int + + +@dataclass(frozen=True) +class ConditionStatistics: + """ + :ivar int tasks_waiting: number of tasks blocked on :meth:`~.Condition.wait` + :ivar ~anyio.LockStatistics lock_statistics: statistics of the underlying + :class:`~.Lock` + """ + + tasks_waiting: int + lock_statistics: LockStatistics + + +@dataclass(frozen=True) +class SemaphoreStatistics: + """ + :ivar int tasks_waiting: number of tasks waiting on :meth:`~.Semaphore.acquire` + + """ + + tasks_waiting: int + + +class Event: + def __new__(cls) -> Event: + try: + return get_async_backend().create_event() + except AsyncLibraryNotFoundError: + return EventAdapter() + + def set(self) -> None: + """Set the flag, notifying all listeners.""" + raise NotImplementedError + + def is_set(self) -> bool: + """Return ``True`` if the flag is set, ``False`` if not.""" + raise NotImplementedError + + async def wait(self) -> None: + """ + Wait until the flag has been set. + + If the flag has already been set when this method is called, it returns + immediately. + + """ + raise NotImplementedError + + def statistics(self) -> EventStatistics: + """Return statistics about the current state of this event.""" + raise NotImplementedError + + +class EventAdapter(Event): + _internal_event: Event | None = None + _is_set: bool = False + + def __new__(cls) -> EventAdapter: + return object.__new__(cls) + + @property + def _event(self) -> Event: + if self._internal_event is None: + self._internal_event = get_async_backend().create_event() + if self._is_set: + self._internal_event.set() + + return self._internal_event + + def set(self) -> None: + if self._internal_event is None: + self._is_set = True + else: + self._event.set() + + def is_set(self) -> bool: + if self._internal_event is None: + return self._is_set + + return self._internal_event.is_set() + + async def wait(self) -> None: + await self._event.wait() + + def statistics(self) -> EventStatistics: + if self._internal_event is None: + return EventStatistics(tasks_waiting=0) + + return self._internal_event.statistics() + + +class Lock: + def __new__(cls, *, fast_acquire: bool = False) -> Lock: + try: + return get_async_backend().create_lock(fast_acquire=fast_acquire) + except AsyncLibraryNotFoundError: + return LockAdapter(fast_acquire=fast_acquire) + + async def __aenter__(self) -> None: + await self.acquire() + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self.release() + + async def acquire(self) -> None: + """Acquire the lock.""" + raise NotImplementedError + + def acquire_nowait(self) -> None: + """ + Acquire the lock, without blocking. + + :raises ~anyio.WouldBlock: if the operation would block + + """ + raise NotImplementedError + + def release(self) -> None: + """Release the lock.""" + raise NotImplementedError + + def locked(self) -> bool: + """Return True if the lock is currently held.""" + raise NotImplementedError + + def statistics(self) -> LockStatistics: + """ + Return statistics about the current state of this lock. + + .. versionadded:: 3.0 + """ + raise NotImplementedError + + +class LockAdapter(Lock): + _internal_lock: Lock | None = None + + def __new__(cls, *, fast_acquire: bool = False) -> LockAdapter: + return object.__new__(cls) + + def __init__(self, *, fast_acquire: bool = False): + self._fast_acquire = fast_acquire + + @property + def _lock(self) -> Lock: + if self._internal_lock is None: + self._internal_lock = get_async_backend().create_lock( + fast_acquire=self._fast_acquire + ) + + return self._internal_lock + + async def __aenter__(self) -> None: + await self._lock.acquire() + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + if self._internal_lock is not None: + self._internal_lock.release() + + async def acquire(self) -> None: + """Acquire the lock.""" + await self._lock.acquire() + + def acquire_nowait(self) -> None: + """ + Acquire the lock, without blocking. + + :raises ~anyio.WouldBlock: if the operation would block + + """ + self._lock.acquire_nowait() + + def release(self) -> None: + """Release the lock.""" + self._lock.release() + + def locked(self) -> bool: + """Return True if the lock is currently held.""" + return self._lock.locked() + + def statistics(self) -> LockStatistics: + """ + Return statistics about the current state of this lock. + + .. versionadded:: 3.0 + + """ + if self._internal_lock is None: + return LockStatistics(False, None, 0) + + return self._internal_lock.statistics() + + +class Condition: + _owner_task: TaskInfo | None = None + + def __init__(self, lock: Lock | None = None): + self._lock = lock or Lock() + self._waiters: deque[Event] = deque() + + async def __aenter__(self) -> None: + await self.acquire() + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self.release() + + def _check_acquired(self) -> None: + if self._owner_task != get_current_task(): + raise RuntimeError("The current task is not holding the underlying lock") + + async def acquire(self) -> None: + """Acquire the underlying lock.""" + await self._lock.acquire() + self._owner_task = get_current_task() + + def acquire_nowait(self) -> None: + """ + Acquire the underlying lock, without blocking. + + :raises ~anyio.WouldBlock: if the operation would block + + """ + self._lock.acquire_nowait() + self._owner_task = get_current_task() + + def release(self) -> None: + """Release the underlying lock.""" + self._lock.release() + + def locked(self) -> bool: + """Return True if the lock is set.""" + return self._lock.locked() + + def notify(self, n: int = 1) -> None: + """Notify exactly n listeners.""" + self._check_acquired() + for _ in range(n): + try: + event = self._waiters.popleft() + except IndexError: + break + + event.set() + + def notify_all(self) -> None: + """Notify all the listeners.""" + self._check_acquired() + for event in self._waiters: + event.set() + + self._waiters.clear() + + async def wait(self) -> None: + """Wait for a notification.""" + await checkpoint() + event = Event() + self._waiters.append(event) + self.release() + try: + await event.wait() + except BaseException: + if not event.is_set(): + self._waiters.remove(event) + + raise + finally: + with CancelScope(shield=True): + await self.acquire() + + def statistics(self) -> ConditionStatistics: + """ + Return statistics about the current state of this condition. + + .. versionadded:: 3.0 + """ + return ConditionStatistics(len(self._waiters), self._lock.statistics()) + + +class Semaphore: + def __new__( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> Semaphore: + try: + return get_async_backend().create_semaphore( + initial_value, max_value=max_value, fast_acquire=fast_acquire + ) + except AsyncLibraryNotFoundError: + return SemaphoreAdapter(initial_value, max_value=max_value) + + def __init__( + self, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ): + if not isinstance(initial_value, int): + raise TypeError("initial_value must be an integer") + if initial_value < 0: + raise ValueError("initial_value must be >= 0") + if max_value is not None: + if not isinstance(max_value, int): + raise TypeError("max_value must be an integer or None") + if max_value < initial_value: + raise ValueError( + "max_value must be equal to or higher than initial_value" + ) + + self._fast_acquire = fast_acquire + + async def __aenter__(self) -> Semaphore: + await self.acquire() + return self + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self.release() + + async def acquire(self) -> None: + """Decrement the semaphore value, blocking if necessary.""" + raise NotImplementedError + + def acquire_nowait(self) -> None: + """ + Acquire the underlying lock, without blocking. + + :raises ~anyio.WouldBlock: if the operation would block + + """ + raise NotImplementedError + + def release(self) -> None: + """Increment the semaphore value.""" + raise NotImplementedError + + @property + def value(self) -> int: + """The current value of the semaphore.""" + raise NotImplementedError + + @property + def max_value(self) -> int | None: + """The maximum value of the semaphore.""" + raise NotImplementedError + + def statistics(self) -> SemaphoreStatistics: + """ + Return statistics about the current state of this semaphore. + + .. versionadded:: 3.0 + """ + raise NotImplementedError + + +class SemaphoreAdapter(Semaphore): + _internal_semaphore: Semaphore | None = None + + def __new__( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> SemaphoreAdapter: + return object.__new__(cls) + + def __init__( + self, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> None: + super().__init__(initial_value, max_value=max_value, fast_acquire=fast_acquire) + self._initial_value = initial_value + self._max_value = max_value + + @property + def _semaphore(self) -> Semaphore: + if self._internal_semaphore is None: + self._internal_semaphore = get_async_backend().create_semaphore( + self._initial_value, max_value=self._max_value + ) + + return self._internal_semaphore + + async def acquire(self) -> None: + await self._semaphore.acquire() + + def acquire_nowait(self) -> None: + self._semaphore.acquire_nowait() + + def release(self) -> None: + self._semaphore.release() + + @property + def value(self) -> int: + if self._internal_semaphore is None: + return self._initial_value + + return self._semaphore.value + + @property + def max_value(self) -> int | None: + return self._max_value + + def statistics(self) -> SemaphoreStatistics: + if self._internal_semaphore is None: + return SemaphoreStatistics(tasks_waiting=0) + + return self._semaphore.statistics() + + +class CapacityLimiter: + def __new__(cls, total_tokens: float) -> CapacityLimiter: + try: + return get_async_backend().create_capacity_limiter(total_tokens) + except AsyncLibraryNotFoundError: + return CapacityLimiterAdapter(total_tokens) + + async def __aenter__(self) -> None: + raise NotImplementedError + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + raise NotImplementedError + + @property + def total_tokens(self) -> float: + """ + The total number of tokens available for borrowing. + + This is a read-write property. If the total number of tokens is increased, the + proportionate number of tasks waiting on this limiter will be granted their + tokens. + + .. versionchanged:: 3.0 + The property is now writable. + + """ + raise NotImplementedError + + @total_tokens.setter + def total_tokens(self, value: float) -> None: + raise NotImplementedError + + @property + def borrowed_tokens(self) -> int: + """The number of tokens that have currently been borrowed.""" + raise NotImplementedError + + @property + def available_tokens(self) -> float: + """The number of tokens currently available to be borrowed""" + raise NotImplementedError + + def acquire_nowait(self) -> None: + """ + Acquire a token for the current task without waiting for one to become + available. + + :raises ~anyio.WouldBlock: if there are no tokens available for borrowing + + """ + raise NotImplementedError + + def acquire_on_behalf_of_nowait(self, borrower: object) -> None: + """ + Acquire a token without waiting for one to become available. + + :param borrower: the entity borrowing a token + :raises ~anyio.WouldBlock: if there are no tokens available for borrowing + + """ + raise NotImplementedError + + async def acquire(self) -> None: + """ + Acquire a token for the current task, waiting if necessary for one to become + available. + + """ + raise NotImplementedError + + async def acquire_on_behalf_of(self, borrower: object) -> None: + """ + Acquire a token, waiting if necessary for one to become available. + + :param borrower: the entity borrowing a token + + """ + raise NotImplementedError + + def release(self) -> None: + """ + Release the token held by the current task. + + :raises RuntimeError: if the current task has not borrowed a token from this + limiter. + + """ + raise NotImplementedError + + def release_on_behalf_of(self, borrower: object) -> None: + """ + Release the token held by the given borrower. + + :raises RuntimeError: if the borrower has not borrowed a token from this + limiter. + + """ + raise NotImplementedError + + def statistics(self) -> CapacityLimiterStatistics: + """ + Return statistics about the current state of this limiter. + + .. versionadded:: 3.0 + + """ + raise NotImplementedError + + +class CapacityLimiterAdapter(CapacityLimiter): + _internal_limiter: CapacityLimiter | None = None + + def __new__(cls, total_tokens: float) -> CapacityLimiterAdapter: + return object.__new__(cls) + + def __init__(self, total_tokens: float) -> None: + self.total_tokens = total_tokens + + @property + def _limiter(self) -> CapacityLimiter: + if self._internal_limiter is None: + self._internal_limiter = get_async_backend().create_capacity_limiter( + self._total_tokens + ) + + return self._internal_limiter + + async def __aenter__(self) -> None: + await self._limiter.__aenter__() + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + return await self._limiter.__aexit__(exc_type, exc_val, exc_tb) + + @property + def total_tokens(self) -> float: + if self._internal_limiter is None: + return self._total_tokens + + return self._internal_limiter.total_tokens + + @total_tokens.setter + def total_tokens(self, value: float) -> None: + if not isinstance(value, int) and value is not math.inf: + raise TypeError("total_tokens must be an int or math.inf") + elif value < 1: + raise ValueError("total_tokens must be >= 1") + + if self._internal_limiter is None: + self._total_tokens = value + return + + self._limiter.total_tokens = value + + @property + def borrowed_tokens(self) -> int: + if self._internal_limiter is None: + return 0 + + return self._internal_limiter.borrowed_tokens + + @property + def available_tokens(self) -> float: + if self._internal_limiter is None: + return self._total_tokens + + return self._internal_limiter.available_tokens + + def acquire_nowait(self) -> None: + self._limiter.acquire_nowait() + + def acquire_on_behalf_of_nowait(self, borrower: object) -> None: + self._limiter.acquire_on_behalf_of_nowait(borrower) + + async def acquire(self) -> None: + await self._limiter.acquire() + + async def acquire_on_behalf_of(self, borrower: object) -> None: + await self._limiter.acquire_on_behalf_of(borrower) + + def release(self) -> None: + self._limiter.release() + + def release_on_behalf_of(self, borrower: object) -> None: + self._limiter.release_on_behalf_of(borrower) + + def statistics(self) -> CapacityLimiterStatistics: + if self._internal_limiter is None: + return CapacityLimiterStatistics( + borrowed_tokens=0, + total_tokens=self.total_tokens, + borrowers=(), + tasks_waiting=0, + ) + + return self._internal_limiter.statistics() + + +class ResourceGuard: + """ + A context manager for ensuring that a resource is only used by a single task at a + time. + + Entering this context manager while the previous has not exited it yet will trigger + :exc:`BusyResourceError`. + + :param action: the action to guard against (visible in the :exc:`BusyResourceError` + when triggered, e.g. "Another task is already {action} this resource") + + .. versionadded:: 4.1 + """ + + __slots__ = "action", "_guarded" + + def __init__(self, action: str = "using"): + self.action: str = action + self._guarded = False + + def __enter__(self) -> None: + if self._guarded: + raise BusyResourceError(self.action) + + self._guarded = True + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self._guarded = False diff --git a/.venv/Lib/site-packages/anyio/_core/_tasks.py b/.venv/Lib/site-packages/anyio/_core/_tasks.py new file mode 100644 index 0000000..fe49015 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_tasks.py @@ -0,0 +1,158 @@ +from __future__ import annotations + +import math +from collections.abc import Generator +from contextlib import contextmanager +from types import TracebackType + +from ..abc._tasks import TaskGroup, TaskStatus +from ._eventloop import get_async_backend + + +class _IgnoredTaskStatus(TaskStatus[object]): + def started(self, value: object = None) -> None: + pass + + +TASK_STATUS_IGNORED = _IgnoredTaskStatus() + + +class CancelScope: + """ + Wraps a unit of work that can be made separately cancellable. + + :param deadline: The time (clock value) when this scope is cancelled automatically + :param shield: ``True`` to shield the cancel scope from external cancellation + """ + + def __new__( + cls, *, deadline: float = math.inf, shield: bool = False + ) -> CancelScope: + return get_async_backend().create_cancel_scope(shield=shield, deadline=deadline) + + def cancel(self) -> None: + """Cancel this scope immediately.""" + raise NotImplementedError + + @property + def deadline(self) -> float: + """ + The time (clock value) when this scope is cancelled automatically. + + Will be ``float('inf')`` if no timeout has been set. + + """ + raise NotImplementedError + + @deadline.setter + def deadline(self, value: float) -> None: + raise NotImplementedError + + @property + def cancel_called(self) -> bool: + """``True`` if :meth:`cancel` has been called.""" + raise NotImplementedError + + @property + def cancelled_caught(self) -> bool: + """ + ``True`` if this scope suppressed a cancellation exception it itself raised. + + This is typically used to check if any work was interrupted, or to see if the + scope was cancelled due to its deadline being reached. The value will, however, + only be ``True`` if the cancellation was triggered by the scope itself (and not + an outer scope). + + """ + raise NotImplementedError + + @property + def shield(self) -> bool: + """ + ``True`` if this scope is shielded from external cancellation. + + While a scope is shielded, it will not receive cancellations from outside. + + """ + raise NotImplementedError + + @shield.setter + def shield(self, value: bool) -> None: + raise NotImplementedError + + def __enter__(self) -> CancelScope: + raise NotImplementedError + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool: + raise NotImplementedError + + +@contextmanager +def fail_after( + delay: float | None, shield: bool = False +) -> Generator[CancelScope, None, None]: + """ + Create a context manager which raises a :class:`TimeoutError` if does not finish in + time. + + :param delay: maximum allowed time (in seconds) before raising the exception, or + ``None`` to disable the timeout + :param shield: ``True`` to shield the cancel scope from external cancellation + :return: a context manager that yields a cancel scope + :rtype: :class:`~typing.ContextManager`\\[:class:`~anyio.CancelScope`\\] + + """ + current_time = get_async_backend().current_time + deadline = (current_time() + delay) if delay is not None else math.inf + with get_async_backend().create_cancel_scope( + deadline=deadline, shield=shield + ) as cancel_scope: + yield cancel_scope + + if cancel_scope.cancelled_caught and current_time() >= cancel_scope.deadline: + raise TimeoutError + + +def move_on_after(delay: float | None, shield: bool = False) -> CancelScope: + """ + Create a cancel scope with a deadline that expires after the given delay. + + :param delay: maximum allowed time (in seconds) before exiting the context block, or + ``None`` to disable the timeout + :param shield: ``True`` to shield the cancel scope from external cancellation + :return: a cancel scope + + """ + deadline = ( + (get_async_backend().current_time() + delay) if delay is not None else math.inf + ) + return get_async_backend().create_cancel_scope(deadline=deadline, shield=shield) + + +def current_effective_deadline() -> float: + """ + Return the nearest deadline among all the cancel scopes effective for the current + task. + + :return: a clock value from the event loop's internal clock (or ``float('inf')`` if + there is no deadline in effect, or ``float('-inf')`` if the current scope has + been cancelled) + :rtype: float + + """ + return get_async_backend().current_effective_deadline() + + +def create_task_group() -> TaskGroup: + """ + Create a task group. + + :return: a task group + + """ + return get_async_backend().create_task_group() diff --git a/.venv/Lib/site-packages/anyio/_core/_tempfile.py b/.venv/Lib/site-packages/anyio/_core/_tempfile.py new file mode 100644 index 0000000..26d70ec --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_tempfile.py @@ -0,0 +1,616 @@ +from __future__ import annotations + +import os +import sys +import tempfile +from collections.abc import Iterable +from io import BytesIO, TextIOWrapper +from types import TracebackType +from typing import ( + TYPE_CHECKING, + Any, + AnyStr, + Generic, + overload, +) + +from .. import to_thread +from .._core._fileio import AsyncFile +from ..lowlevel import checkpoint_if_cancelled + +if TYPE_CHECKING: + from _typeshed import OpenBinaryMode, OpenTextMode, ReadableBuffer, WriteableBuffer + + +class TemporaryFile(Generic[AnyStr]): + """ + An asynchronous temporary file that is automatically created and cleaned up. + + This class provides an asynchronous context manager interface to a temporary file. + The file is created using Python's standard `tempfile.TemporaryFile` function in a + background thread, and is wrapped as an asynchronous file using `AsyncFile`. + + :param mode: The mode in which the file is opened. Defaults to "w+b". + :param buffering: The buffering policy (-1 means the default buffering). + :param encoding: The encoding used to decode or encode the file. Only applicable in + text mode. + :param newline: Controls how universal newlines mode works (only applicable in text + mode). + :param suffix: The suffix for the temporary file name. + :param prefix: The prefix for the temporary file name. + :param dir: The directory in which the temporary file is created. + :param errors: The error handling scheme used for encoding/decoding errors. + """ + + _async_file: AsyncFile[AnyStr] + + @overload + def __init__( + self: TemporaryFile[bytes], + mode: OpenBinaryMode = ..., + buffering: int = ..., + encoding: str | None = ..., + newline: str | None = ..., + suffix: str | None = ..., + prefix: str | None = ..., + dir: str | None = ..., + *, + errors: str | None = ..., + ): ... + @overload + def __init__( + self: TemporaryFile[str], + mode: OpenTextMode, + buffering: int = ..., + encoding: str | None = ..., + newline: str | None = ..., + suffix: str | None = ..., + prefix: str | None = ..., + dir: str | None = ..., + *, + errors: str | None = ..., + ): ... + + def __init__( + self, + mode: OpenTextMode | OpenBinaryMode = "w+b", + buffering: int = -1, + encoding: str | None = None, + newline: str | None = None, + suffix: str | None = None, + prefix: str | None = None, + dir: str | None = None, + *, + errors: str | None = None, + ) -> None: + self.mode = mode + self.buffering = buffering + self.encoding = encoding + self.newline = newline + self.suffix: str | None = suffix + self.prefix: str | None = prefix + self.dir: str | None = dir + self.errors = errors + + async def __aenter__(self) -> AsyncFile[AnyStr]: + fp = await to_thread.run_sync( + lambda: tempfile.TemporaryFile( + self.mode, + self.buffering, + self.encoding, + self.newline, + self.suffix, + self.prefix, + self.dir, + errors=self.errors, + ) + ) + self._async_file = AsyncFile(fp) + return self._async_file + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_value: BaseException | None, + traceback: TracebackType | None, + ) -> None: + await self._async_file.aclose() + + +class NamedTemporaryFile(Generic[AnyStr]): + """ + An asynchronous named temporary file that is automatically created and cleaned up. + + This class provides an asynchronous context manager for a temporary file with a + visible name in the file system. It uses Python's standard + :func:`~tempfile.NamedTemporaryFile` function and wraps the file object with + :class:`AsyncFile` for asynchronous operations. + + :param mode: The mode in which the file is opened. Defaults to "w+b". + :param buffering: The buffering policy (-1 means the default buffering). + :param encoding: The encoding used to decode or encode the file. Only applicable in + text mode. + :param newline: Controls how universal newlines mode works (only applicable in text + mode). + :param suffix: The suffix for the temporary file name. + :param prefix: The prefix for the temporary file name. + :param dir: The directory in which the temporary file is created. + :param delete: Whether to delete the file when it is closed. + :param errors: The error handling scheme used for encoding/decoding errors. + :param delete_on_close: (Python 3.12+) Whether to delete the file on close. + """ + + _async_file: AsyncFile[AnyStr] + + @overload + def __init__( + self: NamedTemporaryFile[bytes], + mode: OpenBinaryMode = ..., + buffering: int = ..., + encoding: str | None = ..., + newline: str | None = ..., + suffix: str | None = ..., + prefix: str | None = ..., + dir: str | None = ..., + delete: bool = ..., + *, + errors: str | None = ..., + delete_on_close: bool = ..., + ): ... + @overload + def __init__( + self: NamedTemporaryFile[str], + mode: OpenTextMode, + buffering: int = ..., + encoding: str | None = ..., + newline: str | None = ..., + suffix: str | None = ..., + prefix: str | None = ..., + dir: str | None = ..., + delete: bool = ..., + *, + errors: str | None = ..., + delete_on_close: bool = ..., + ): ... + + def __init__( + self, + mode: OpenBinaryMode | OpenTextMode = "w+b", + buffering: int = -1, + encoding: str | None = None, + newline: str | None = None, + suffix: str | None = None, + prefix: str | None = None, + dir: str | None = None, + delete: bool = True, + *, + errors: str | None = None, + delete_on_close: bool = True, + ) -> None: + self._params: dict[str, Any] = { + "mode": mode, + "buffering": buffering, + "encoding": encoding, + "newline": newline, + "suffix": suffix, + "prefix": prefix, + "dir": dir, + "delete": delete, + "errors": errors, + } + if sys.version_info >= (3, 12): + self._params["delete_on_close"] = delete_on_close + + async def __aenter__(self) -> AsyncFile[AnyStr]: + fp = await to_thread.run_sync( + lambda: tempfile.NamedTemporaryFile(**self._params) + ) + self._async_file = AsyncFile(fp) + return self._async_file + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_value: BaseException | None, + traceback: TracebackType | None, + ) -> None: + await self._async_file.aclose() + + +class SpooledTemporaryFile(AsyncFile[AnyStr]): + """ + An asynchronous spooled temporary file that starts in memory and is spooled to disk. + + This class provides an asynchronous interface to a spooled temporary file, much like + Python's standard :class:`~tempfile.SpooledTemporaryFile`. It supports asynchronous + write operations and provides a method to force a rollover to disk. + + :param max_size: Maximum size in bytes before the file is rolled over to disk. + :param mode: The mode in which the file is opened. Defaults to "w+b". + :param buffering: The buffering policy (-1 means the default buffering). + :param encoding: The encoding used to decode or encode the file (text mode only). + :param newline: Controls how universal newlines mode works (text mode only). + :param suffix: The suffix for the temporary file name. + :param prefix: The prefix for the temporary file name. + :param dir: The directory in which the temporary file is created. + :param errors: The error handling scheme used for encoding/decoding errors. + """ + + _rolled: bool = False + + @overload + def __init__( + self: SpooledTemporaryFile[bytes], + max_size: int = ..., + mode: OpenBinaryMode = ..., + buffering: int = ..., + encoding: str | None = ..., + newline: str | None = ..., + suffix: str | None = ..., + prefix: str | None = ..., + dir: str | None = ..., + *, + errors: str | None = ..., + ): ... + @overload + def __init__( + self: SpooledTemporaryFile[str], + max_size: int = ..., + mode: OpenTextMode = ..., + buffering: int = ..., + encoding: str | None = ..., + newline: str | None = ..., + suffix: str | None = ..., + prefix: str | None = ..., + dir: str | None = ..., + *, + errors: str | None = ..., + ): ... + + def __init__( + self, + max_size: int = 0, + mode: OpenBinaryMode | OpenTextMode = "w+b", + buffering: int = -1, + encoding: str | None = None, + newline: str | None = None, + suffix: str | None = None, + prefix: str | None = None, + dir: str | None = None, + *, + errors: str | None = None, + ) -> None: + self._tempfile_params: dict[str, Any] = { + "mode": mode, + "buffering": buffering, + "encoding": encoding, + "newline": newline, + "suffix": suffix, + "prefix": prefix, + "dir": dir, + "errors": errors, + } + self._max_size = max_size + if "b" in mode: + super().__init__(BytesIO()) # type: ignore[arg-type] + else: + super().__init__( + TextIOWrapper( # type: ignore[arg-type] + BytesIO(), + encoding=encoding, + errors=errors, + newline=newline, + write_through=True, + ) + ) + + async def aclose(self) -> None: + if not self._rolled: + self._fp.close() + return + + await super().aclose() + + async def _check(self) -> None: + if self._rolled or self._fp.tell() < self._max_size: + return + + await self.rollover() + + async def rollover(self) -> None: + if self._rolled: + return + + self._rolled = True + buffer = self._fp + buffer.seek(0) + self._fp = await to_thread.run_sync( + lambda: tempfile.TemporaryFile(**self._tempfile_params) + ) + await self.write(buffer.read()) + buffer.close() + + @property + def closed(self) -> bool: + return self._fp.closed + + async def read(self, size: int = -1) -> AnyStr: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.read(size) + + return await super().read(size) # type: ignore[return-value] + + async def read1(self: SpooledTemporaryFile[bytes], size: int = -1) -> bytes: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.read1(size) + + return await super().read1(size) + + async def readline(self) -> AnyStr: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.readline() + + return await super().readline() # type: ignore[return-value] + + async def readlines(self) -> list[AnyStr]: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.readlines() + + return await super().readlines() # type: ignore[return-value] + + async def readinto(self: SpooledTemporaryFile[bytes], b: WriteableBuffer) -> int: + if not self._rolled: + await checkpoint_if_cancelled() + self._fp.readinto(b) + + return await super().readinto(b) + + async def readinto1(self: SpooledTemporaryFile[bytes], b: WriteableBuffer) -> int: + if not self._rolled: + await checkpoint_if_cancelled() + self._fp.readinto(b) + + return await super().readinto1(b) + + async def seek(self, offset: int, whence: int | None = os.SEEK_SET) -> int: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.seek(offset, whence) + + return await super().seek(offset, whence) + + async def tell(self) -> int: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.tell() + + return await super().tell() + + async def truncate(self, size: int | None = None) -> int: + if not self._rolled: + await checkpoint_if_cancelled() + return self._fp.truncate(size) + + return await super().truncate(size) + + @overload + async def write(self: SpooledTemporaryFile[bytes], b: ReadableBuffer) -> int: ... + @overload + async def write(self: SpooledTemporaryFile[str], b: str) -> int: ... + + async def write(self, b: ReadableBuffer | str) -> int: + """ + Asynchronously write data to the spooled temporary file. + + If the file has not yet been rolled over, the data is written synchronously, + and a rollover is triggered if the size exceeds the maximum size. + + :param s: The data to write. + :return: The number of bytes written. + :raises RuntimeError: If the underlying file is not initialized. + + """ + if not self._rolled: + await checkpoint_if_cancelled() + result = self._fp.write(b) + await self._check() + return result + + return await super().write(b) # type: ignore[misc] + + @overload + async def writelines( + self: SpooledTemporaryFile[bytes], lines: Iterable[ReadableBuffer] + ) -> None: ... + @overload + async def writelines( + self: SpooledTemporaryFile[str], lines: Iterable[str] + ) -> None: ... + + async def writelines(self, lines: Iterable[str] | Iterable[ReadableBuffer]) -> None: + """ + Asynchronously write a list of lines to the spooled temporary file. + + If the file has not yet been rolled over, the lines are written synchronously, + and a rollover is triggered if the size exceeds the maximum size. + + :param lines: An iterable of lines to write. + :raises RuntimeError: If the underlying file is not initialized. + + """ + if not self._rolled: + await checkpoint_if_cancelled() + result = self._fp.writelines(lines) + await self._check() + return result + + return await super().writelines(lines) # type: ignore[misc] + + +class TemporaryDirectory(Generic[AnyStr]): + """ + An asynchronous temporary directory that is created and cleaned up automatically. + + This class provides an asynchronous context manager for creating a temporary + directory. It wraps Python's standard :class:`~tempfile.TemporaryDirectory` to + perform directory creation and cleanup operations in a background thread. + + :param suffix: Suffix to be added to the temporary directory name. + :param prefix: Prefix to be added to the temporary directory name. + :param dir: The parent directory where the temporary directory is created. + :param ignore_cleanup_errors: Whether to ignore errors during cleanup + (Python 3.10+). + :param delete: Whether to delete the directory upon closing (Python 3.12+). + """ + + def __init__( + self, + suffix: AnyStr | None = None, + prefix: AnyStr | None = None, + dir: AnyStr | None = None, + *, + ignore_cleanup_errors: bool = False, + delete: bool = True, + ) -> None: + self.suffix: AnyStr | None = suffix + self.prefix: AnyStr | None = prefix + self.dir: AnyStr | None = dir + self.ignore_cleanup_errors = ignore_cleanup_errors + self.delete = delete + + self._tempdir: tempfile.TemporaryDirectory | None = None + + async def __aenter__(self) -> str: + params: dict[str, Any] = { + "suffix": self.suffix, + "prefix": self.prefix, + "dir": self.dir, + } + if sys.version_info >= (3, 10): + params["ignore_cleanup_errors"] = self.ignore_cleanup_errors + + if sys.version_info >= (3, 12): + params["delete"] = self.delete + + self._tempdir = await to_thread.run_sync( + lambda: tempfile.TemporaryDirectory(**params) + ) + return await to_thread.run_sync(self._tempdir.__enter__) + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_value: BaseException | None, + traceback: TracebackType | None, + ) -> None: + if self._tempdir is not None: + await to_thread.run_sync( + self._tempdir.__exit__, exc_type, exc_value, traceback + ) + + async def cleanup(self) -> None: + if self._tempdir is not None: + await to_thread.run_sync(self._tempdir.cleanup) + + +@overload +async def mkstemp( + suffix: str | None = None, + prefix: str | None = None, + dir: str | None = None, + text: bool = False, +) -> tuple[int, str]: ... + + +@overload +async def mkstemp( + suffix: bytes | None = None, + prefix: bytes | None = None, + dir: bytes | None = None, + text: bool = False, +) -> tuple[int, bytes]: ... + + +async def mkstemp( + suffix: AnyStr | None = None, + prefix: AnyStr | None = None, + dir: AnyStr | None = None, + text: bool = False, +) -> tuple[int, str | bytes]: + """ + Asynchronously create a temporary file and return an OS-level handle and the file + name. + + This function wraps `tempfile.mkstemp` and executes it in a background thread. + + :param suffix: Suffix to be added to the file name. + :param prefix: Prefix to be added to the file name. + :param dir: Directory in which the temporary file is created. + :param text: Whether the file is opened in text mode. + :return: A tuple containing the file descriptor and the file name. + + """ + return await to_thread.run_sync(tempfile.mkstemp, suffix, prefix, dir, text) + + +@overload +async def mkdtemp( + suffix: str | None = None, + prefix: str | None = None, + dir: str | None = None, +) -> str: ... + + +@overload +async def mkdtemp( + suffix: bytes | None = None, + prefix: bytes | None = None, + dir: bytes | None = None, +) -> bytes: ... + + +async def mkdtemp( + suffix: AnyStr | None = None, + prefix: AnyStr | None = None, + dir: AnyStr | None = None, +) -> str | bytes: + """ + Asynchronously create a temporary directory and return its path. + + This function wraps `tempfile.mkdtemp` and executes it in a background thread. + + :param suffix: Suffix to be added to the directory name. + :param prefix: Prefix to be added to the directory name. + :param dir: Parent directory where the temporary directory is created. + :return: The path of the created temporary directory. + + """ + return await to_thread.run_sync(tempfile.mkdtemp, suffix, prefix, dir) + + +async def gettempdir() -> str: + """ + Asynchronously return the name of the directory used for temporary files. + + This function wraps `tempfile.gettempdir` and executes it in a background thread. + + :return: The path of the temporary directory as a string. + + """ + return await to_thread.run_sync(tempfile.gettempdir) + + +async def gettempdirb() -> bytes: + """ + Asynchronously return the name of the directory used for temporary files in bytes. + + This function wraps `tempfile.gettempdirb` and executes it in a background thread. + + :return: The path of the temporary directory as bytes. + + """ + return await to_thread.run_sync(tempfile.gettempdirb) diff --git a/.venv/Lib/site-packages/anyio/_core/_testing.py b/.venv/Lib/site-packages/anyio/_core/_testing.py new file mode 100644 index 0000000..9e28b22 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_testing.py @@ -0,0 +1,78 @@ +from __future__ import annotations + +from collections.abc import Awaitable, Generator +from typing import Any, cast + +from ._eventloop import get_async_backend + + +class TaskInfo: + """ + Represents an asynchronous task. + + :ivar int id: the unique identifier of the task + :ivar parent_id: the identifier of the parent task, if any + :vartype parent_id: Optional[int] + :ivar str name: the description of the task (if any) + :ivar ~collections.abc.Coroutine coro: the coroutine object of the task + """ + + __slots__ = "_name", "id", "parent_id", "name", "coro" + + def __init__( + self, + id: int, + parent_id: int | None, + name: str | None, + coro: Generator[Any, Any, Any] | Awaitable[Any], + ): + func = get_current_task + self._name = f"{func.__module__}.{func.__qualname__}" + self.id: int = id + self.parent_id: int | None = parent_id + self.name: str | None = name + self.coro: Generator[Any, Any, Any] | Awaitable[Any] = coro + + def __eq__(self, other: object) -> bool: + if isinstance(other, TaskInfo): + return self.id == other.id + + return NotImplemented + + def __hash__(self) -> int: + return hash(self.id) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}(id={self.id!r}, name={self.name!r})" + + def has_pending_cancellation(self) -> bool: + """ + Return ``True`` if the task has a cancellation pending, ``False`` otherwise. + + """ + return False + + +def get_current_task() -> TaskInfo: + """ + Return the current task. + + :return: a representation of the current task + + """ + return get_async_backend().get_current_task() + + +def get_running_tasks() -> list[TaskInfo]: + """ + Return a list of running tasks in the current event loop. + + :return: a list of task info objects + + """ + return cast("list[TaskInfo]", get_async_backend().get_running_tasks()) + + +async def wait_all_tasks_blocked() -> None: + """Wait until all other tasks are waiting for something.""" + await get_async_backend().wait_all_tasks_blocked() diff --git a/.venv/Lib/site-packages/anyio/_core/_typedattr.py b/.venv/Lib/site-packages/anyio/_core/_typedattr.py new file mode 100644 index 0000000..f358a44 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/_core/_typedattr.py @@ -0,0 +1,81 @@ +from __future__ import annotations + +from collections.abc import Callable, Mapping +from typing import Any, TypeVar, final, overload + +from ._exceptions import TypedAttributeLookupError + +T_Attr = TypeVar("T_Attr") +T_Default = TypeVar("T_Default") +undefined = object() + + +def typed_attribute() -> Any: + """Return a unique object, used to mark typed attributes.""" + return object() + + +class TypedAttributeSet: + """ + Superclass for typed attribute collections. + + Checks that every public attribute of every subclass has a type annotation. + """ + + def __init_subclass__(cls) -> None: + annotations: dict[str, Any] = getattr(cls, "__annotations__", {}) + for attrname in dir(cls): + if not attrname.startswith("_") and attrname not in annotations: + raise TypeError( + f"Attribute {attrname!r} is missing its type annotation" + ) + + super().__init_subclass__() + + +class TypedAttributeProvider: + """Base class for classes that wish to provide typed extra attributes.""" + + @property + def extra_attributes(self) -> Mapping[T_Attr, Callable[[], T_Attr]]: + """ + A mapping of the extra attributes to callables that return the corresponding + values. + + If the provider wraps another provider, the attributes from that wrapper should + also be included in the returned mapping (but the wrapper may override the + callables from the wrapped instance). + + """ + return {} + + @overload + def extra(self, attribute: T_Attr) -> T_Attr: ... + + @overload + def extra(self, attribute: T_Attr, default: T_Default) -> T_Attr | T_Default: ... + + @final + def extra(self, attribute: Any, default: object = undefined) -> object: + """ + extra(attribute, default=undefined) + + Return the value of the given typed extra attribute. + + :param attribute: the attribute (member of a :class:`~TypedAttributeSet`) to + look for + :param default: the value that should be returned if no value is found for the + attribute + :raises ~anyio.TypedAttributeLookupError: if the search failed and no default + value was given + + """ + try: + getter = self.extra_attributes[attribute] + except KeyError: + if default is undefined: + raise TypedAttributeLookupError("Attribute not found") from None + else: + return default + + return getter() diff --git a/.venv/Lib/site-packages/anyio/abc/__init__.py b/.venv/Lib/site-packages/anyio/abc/__init__.py new file mode 100644 index 0000000..3d3b61c --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/__init__.py @@ -0,0 +1,55 @@ +from __future__ import annotations + +from ._eventloop import AsyncBackend as AsyncBackend +from ._resources import AsyncResource as AsyncResource +from ._sockets import ConnectedUDPSocket as ConnectedUDPSocket +from ._sockets import ConnectedUNIXDatagramSocket as ConnectedUNIXDatagramSocket +from ._sockets import IPAddressType as IPAddressType +from ._sockets import IPSockAddrType as IPSockAddrType +from ._sockets import SocketAttribute as SocketAttribute +from ._sockets import SocketListener as SocketListener +from ._sockets import SocketStream as SocketStream +from ._sockets import UDPPacketType as UDPPacketType +from ._sockets import UDPSocket as UDPSocket +from ._sockets import UNIXDatagramPacketType as UNIXDatagramPacketType +from ._sockets import UNIXDatagramSocket as UNIXDatagramSocket +from ._sockets import UNIXSocketStream as UNIXSocketStream +from ._streams import AnyByteReceiveStream as AnyByteReceiveStream +from ._streams import AnyByteSendStream as AnyByteSendStream +from ._streams import AnyByteStream as AnyByteStream +from ._streams import AnyUnreliableByteReceiveStream as AnyUnreliableByteReceiveStream +from ._streams import AnyUnreliableByteSendStream as AnyUnreliableByteSendStream +from ._streams import AnyUnreliableByteStream as AnyUnreliableByteStream +from ._streams import ByteReceiveStream as ByteReceiveStream +from ._streams import ByteSendStream as ByteSendStream +from ._streams import ByteStream as ByteStream +from ._streams import Listener as Listener +from ._streams import ObjectReceiveStream as ObjectReceiveStream +from ._streams import ObjectSendStream as ObjectSendStream +from ._streams import ObjectStream as ObjectStream +from ._streams import UnreliableObjectReceiveStream as UnreliableObjectReceiveStream +from ._streams import UnreliableObjectSendStream as UnreliableObjectSendStream +from ._streams import UnreliableObjectStream as UnreliableObjectStream +from ._subprocesses import Process as Process +from ._tasks import TaskGroup as TaskGroup +from ._tasks import TaskStatus as TaskStatus +from ._testing import TestRunner as TestRunner + +# Re-exported here, for backwards compatibility +# isort: off +from .._core._synchronization import ( + CapacityLimiter as CapacityLimiter, + Condition as Condition, + Event as Event, + Lock as Lock, + Semaphore as Semaphore, +) +from .._core._tasks import CancelScope as CancelScope +from ..from_thread import BlockingPortal as BlockingPortal + +# Re-export imports so they look like they live directly in this package +for __value in list(locals().values()): + if getattr(__value, "__module__", "").startswith("anyio.abc."): + __value.__module__ = __name__ + +del __value diff --git a/.venv/Lib/site-packages/anyio/abc/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/anyio/abc/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a58d92d833cdcc99a437375ca33cdd98604ac481 GIT binary patch literal 2244 zcmZvdOK($06vyW#@%x#?ao%s7#36PlO;Ml}HIMR;BCtqORZ~~D*S>>u$$eNe;~=x@ zk_8*o1zmPqvFRu17wD=&(Dq7RRb8+Hp{i0>J!fp^0a(i4zxkgz=Z<@|2jw)NJBtRMUvrWA@rTPA~0M+-LVW0UA&ou!ByBh7<>Z z!!)co1RS9e#bMwmjVg`+$7oD(6gW=fietbDnot}EPST{}1aOL`6eoexG_5!V+)w)z zr-29PfZ~38(82pv(J1sL);u+w1IRbV>0!JMS#hW#F8-V4rtZ=!#RI1*b@h&MIAXF3<}qwrGFkT%;Ej zFWDbEYjjN`J%oJ%f0v$h&i%gEZGe;SZtR)X_O{74^MufK$h*we&Ahq%thXJx-#E$Y zl6k(HC$z_t>{GU`U+u;o=laOk>&=yX;T2kW&5s$b>q$deo-1DA^T3O5h^AZJG^&Tp zHDR1k%c_!@``e{m59Ud5$4}hbx4zmoq*3FBa~w|GDs7l1XF}{X z>sTduOXZ^3aZ>Hc8&Yzs(vWIW+uE^&WG>^77H>Pdk~71BaRSy*!nMjymB{HuW%p05 z<;=8!(~;vPFR)%^l0JB;$SrI?}YTxBb8uN6eLe-wt%EAK7J&Q9tlFc35o7aI4JTt$OXQ+_Yhe z<}b=~pIhRt-{Cl8~B+qAr*QK=Sh=Rd>Xy@qUX2y%QS!C?3t+wr5+a>rQdKr`2XzTsFZel}l|v`2OW1zc zCBA^etX_r9Eb4e~9B|LI9;zFKFJVF+Wf|o>$_j`d?AE66RAbN#lKW914KBq4OCG?&bk}h3JXWE^Pvk8q`On?D zQr;Jgi?U&v+!EzdvwC1~2RaSgUzF>-P{aGhkRC7FUQLuMpt@17>rUhF@`Z8{j`gU# zV^zumTB`tkc4*WX)Wd#Qg??Dob<4G+t{3Y~KYX>_GuQZacsyRK;unzDy_%-A$lTv# ztwk=i$h8(JwK}}6oQrC>(jwPY^h%3tw#ZdweyJwkR71!uw#ageeBL532eS5BuEko4l4FbTx@HvEMD0i#ohHvj+t literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/abc/__pycache__/_eventloop.cpython-312.pyc b/.venv/Lib/site-packages/anyio/abc/__pycache__/_eventloop.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..78a4527fc6b19265dbf2c75d0652f84c1c7b68d6 GIT binary patch literal 14989 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/abc/__pycache__/_resources.cpython-312.pyc b/.venv/Lib/site-packages/anyio/abc/__pycache__/_resources.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f2e5e5f7911a38405faa09ccd0d7dd1632fade24 GIT binary patch literal 1656 zcmZux-ESL35Z}EopY1qq8bcth+EXNoPHI!$5D`M85g%QfzxRB^u#& zXr9u-lULTr8zi)jNLb?f*Y+u#h{LN4%5LR1gf7jiEJ@OgW!*H9u9lZpZ>+t|GnUV? zmdpeTvY2O`Gz81qCWySnf}PDlkHbOkhcquH0=8LKR>_{+iSTb!Gq)Ep2GACvU zYjfe;>2!k*Y|r{4kxtg(PB)PmO9B9yR7}`P;v5>5F#{+Lq_*(i)RbZY>?BSq zv*8S>&wsh|+0N(j5B7!c?F*0P4CwAPF3|_{qH%0pqW@oDv?{V4P>kHw_UG5IWmRiU z2wyI0F0dVnf~z>iJjnZv=?IIIFQcUe6NL8(8FQ`~bbZW)utAqwMIS4{wFOpde-R1# z;0D~J*Y*P5!zbZG=dQD!Li0R@28}7*MD?^%O+5}1)w6h%feu_vpdc1ua?82x`w5G= z?_)E?Y1oet&-ngFeHM*1CEpLz0G6R9GD zjo&qDE{$|Rj}Qq5+^R#M)yiST3*A8zU R&_ApNy7X21PXZt1=O6e3sXqV! literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/abc/__pycache__/_sockets.cpython-312.pyc b/.venv/Lib/site-packages/anyio/abc/__pycache__/_sockets.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a686403ed2e263d592bd16c626efc44860395e06 GIT binary patch literal 9881 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 F|6c)XXgL4? literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/abc/__pycache__/_streams.cpython-312.pyc b/.venv/Lib/site-packages/anyio/abc/__pycache__/_streams.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..070dabe65701add47d9b260d1c5041eb691b6335 GIT binary patch literal 8460 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 N=;{Af@GkuG{{qpNowfh~ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/abc/__pycache__/_subprocesses.cpython-312.pyc b/.venv/Lib/site-packages/anyio/abc/__pycache__/_subprocesses.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c5733ed5baa861d53da42e60b7bbeab4d6c67ffb GIT binary patch literal 3264 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 dxlb1U(9C= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +if sys.version_info >= (3, 10): + from typing import TypeAlias +else: + from typing_extensions import TypeAlias + +if TYPE_CHECKING: + from _typeshed import HasFileno + + from .._core._synchronization import CapacityLimiter, Event, Lock, Semaphore + from .._core._tasks import CancelScope + from .._core._testing import TaskInfo + from ..from_thread import BlockingPortal + from ._sockets import ( + ConnectedUDPSocket, + ConnectedUNIXDatagramSocket, + IPSockAddrType, + SocketListener, + SocketStream, + UDPSocket, + UNIXDatagramSocket, + UNIXSocketStream, + ) + from ._subprocesses import Process + from ._tasks import TaskGroup + from ._testing import TestRunner + +T_Retval = TypeVar("T_Retval") +PosArgsT = TypeVarTuple("PosArgsT") +StrOrBytesPath: TypeAlias = Union[str, bytes, "PathLike[str]", "PathLike[bytes]"] + + +class AsyncBackend(metaclass=ABCMeta): + @classmethod + @abstractmethod + def run( + cls, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + options: dict[str, Any], + ) -> T_Retval: + """ + Run the given coroutine function in an asynchronous event loop. + + The current thread must not be already running an event loop. + + :param func: a coroutine function + :param args: positional arguments to ``func`` + :param kwargs: positional arguments to ``func`` + :param options: keyword arguments to call the backend ``run()`` implementation + with + :return: the return value of the coroutine function + """ + + @classmethod + @abstractmethod + def current_token(cls) -> object: + """ + + :return: + """ + + @classmethod + @abstractmethod + def current_time(cls) -> float: + """ + Return the current value of the event loop's internal clock. + + :return: the clock value (seconds) + """ + + @classmethod + @abstractmethod + def cancelled_exception_class(cls) -> type[BaseException]: + """Return the exception class that is raised in a task if it's cancelled.""" + + @classmethod + @abstractmethod + async def checkpoint(cls) -> None: + """ + Check if the task has been cancelled, and allow rescheduling of other tasks. + + This is effectively the same as running :meth:`checkpoint_if_cancelled` and then + :meth:`cancel_shielded_checkpoint`. + """ + + @classmethod + async def checkpoint_if_cancelled(cls) -> None: + """ + Check if the current task group has been cancelled. + + This will check if the task has been cancelled, but will not allow other tasks + to be scheduled if not. + + """ + if cls.current_effective_deadline() == -math.inf: + await cls.checkpoint() + + @classmethod + async def cancel_shielded_checkpoint(cls) -> None: + """ + Allow the rescheduling of other tasks. + + This will give other tasks the opportunity to run, but without checking if the + current task group has been cancelled, unlike with :meth:`checkpoint`. + + """ + with cls.create_cancel_scope(shield=True): + await cls.sleep(0) + + @classmethod + @abstractmethod + async def sleep(cls, delay: float) -> None: + """ + Pause the current task for the specified duration. + + :param delay: the duration, in seconds + """ + + @classmethod + @abstractmethod + def create_cancel_scope( + cls, *, deadline: float = math.inf, shield: bool = False + ) -> CancelScope: + pass + + @classmethod + @abstractmethod + def current_effective_deadline(cls) -> float: + """ + Return the nearest deadline among all the cancel scopes effective for the + current task. + + :return: + - a clock value from the event loop's internal clock + - ``inf`` if there is no deadline in effect + - ``-inf`` if the current scope has been cancelled + :rtype: float + """ + + @classmethod + @abstractmethod + def create_task_group(cls) -> TaskGroup: + pass + + @classmethod + @abstractmethod + def create_event(cls) -> Event: + pass + + @classmethod + @abstractmethod + def create_lock(cls, *, fast_acquire: bool) -> Lock: + pass + + @classmethod + @abstractmethod + def create_semaphore( + cls, + initial_value: int, + *, + max_value: int | None = None, + fast_acquire: bool = False, + ) -> Semaphore: + pass + + @classmethod + @abstractmethod + def create_capacity_limiter(cls, total_tokens: float) -> CapacityLimiter: + pass + + @classmethod + @abstractmethod + async def run_sync_in_worker_thread( + cls, + func: Callable[[Unpack[PosArgsT]], T_Retval], + args: tuple[Unpack[PosArgsT]], + abandon_on_cancel: bool = False, + limiter: CapacityLimiter | None = None, + ) -> T_Retval: + pass + + @classmethod + @abstractmethod + def check_cancelled(cls) -> None: + pass + + @classmethod + @abstractmethod + def run_async_from_thread( + cls, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + args: tuple[Unpack[PosArgsT]], + token: object, + ) -> T_Retval: + pass + + @classmethod + @abstractmethod + def run_sync_from_thread( + cls, + func: Callable[[Unpack[PosArgsT]], T_Retval], + args: tuple[Unpack[PosArgsT]], + token: object, + ) -> T_Retval: + pass + + @classmethod + @abstractmethod + def create_blocking_portal(cls) -> BlockingPortal: + pass + + @classmethod + @abstractmethod + async def open_process( + cls, + command: StrOrBytesPath | Sequence[StrOrBytesPath], + *, + stdin: int | IO[Any] | None, + stdout: int | IO[Any] | None, + stderr: int | IO[Any] | None, + **kwargs: Any, + ) -> Process: + pass + + @classmethod + @abstractmethod + def setup_process_pool_exit_at_shutdown(cls, workers: set[Process]) -> None: + pass + + @classmethod + @abstractmethod + async def connect_tcp( + cls, host: str, port: int, local_address: IPSockAddrType | None = None + ) -> SocketStream: + pass + + @classmethod + @abstractmethod + async def connect_unix(cls, path: str | bytes) -> UNIXSocketStream: + pass + + @classmethod + @abstractmethod + def create_tcp_listener(cls, sock: socket) -> SocketListener: + pass + + @classmethod + @abstractmethod + def create_unix_listener(cls, sock: socket) -> SocketListener: + pass + + @classmethod + @abstractmethod + async def create_udp_socket( + cls, + family: AddressFamily, + local_address: IPSockAddrType | None, + remote_address: IPSockAddrType | None, + reuse_port: bool, + ) -> UDPSocket | ConnectedUDPSocket: + pass + + @classmethod + @overload + async def create_unix_datagram_socket( + cls, raw_socket: socket, remote_path: None + ) -> UNIXDatagramSocket: ... + + @classmethod + @overload + async def create_unix_datagram_socket( + cls, raw_socket: socket, remote_path: str | bytes + ) -> ConnectedUNIXDatagramSocket: ... + + @classmethod + @abstractmethod + async def create_unix_datagram_socket( + cls, raw_socket: socket, remote_path: str | bytes | None + ) -> UNIXDatagramSocket | ConnectedUNIXDatagramSocket: + pass + + @classmethod + @abstractmethod + async def getaddrinfo( + cls, + host: bytes | str | None, + port: str | int | None, + *, + family: int | AddressFamily = 0, + type: int | SocketKind = 0, + proto: int = 0, + flags: int = 0, + ) -> Sequence[ + tuple[ + AddressFamily, + SocketKind, + int, + str, + tuple[str, int] | tuple[str, int, int, int] | tuple[int, bytes], + ] + ]: + pass + + @classmethod + @abstractmethod + async def getnameinfo( + cls, sockaddr: IPSockAddrType, flags: int = 0 + ) -> tuple[str, str]: + pass + + @classmethod + @abstractmethod + async def wait_readable(cls, obj: HasFileno | int) -> None: + pass + + @classmethod + @abstractmethod + async def wait_writable(cls, obj: HasFileno | int) -> None: + pass + + @classmethod + @abstractmethod + def current_default_thread_limiter(cls) -> CapacityLimiter: + pass + + @classmethod + @abstractmethod + def open_signal_receiver( + cls, *signals: Signals + ) -> AbstractContextManager[AsyncIterator[Signals]]: + pass + + @classmethod + @abstractmethod + def get_current_task(cls) -> TaskInfo: + pass + + @classmethod + @abstractmethod + def get_running_tasks(cls) -> Sequence[TaskInfo]: + pass + + @classmethod + @abstractmethod + async def wait_all_tasks_blocked(cls) -> None: + pass + + @classmethod + @abstractmethod + def create_test_runner(cls, options: dict[str, Any]) -> TestRunner: + pass diff --git a/.venv/Lib/site-packages/anyio/abc/_resources.py b/.venv/Lib/site-packages/anyio/abc/_resources.py new file mode 100644 index 0000000..10df115 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/_resources.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from abc import ABCMeta, abstractmethod +from types import TracebackType +from typing import TypeVar + +T = TypeVar("T") + + +class AsyncResource(metaclass=ABCMeta): + """ + Abstract base class for all closeable asynchronous resources. + + Works as an asynchronous context manager which returns the instance itself on enter, + and calls :meth:`aclose` on exit. + """ + + __slots__ = () + + async def __aenter__(self: T) -> T: + return self + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + await self.aclose() + + @abstractmethod + async def aclose(self) -> None: + """Close the resource.""" diff --git a/.venv/Lib/site-packages/anyio/abc/_sockets.py b/.venv/Lib/site-packages/anyio/abc/_sockets.py new file mode 100644 index 0000000..1c6a450 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/_sockets.py @@ -0,0 +1,194 @@ +from __future__ import annotations + +import socket +from abc import abstractmethod +from collections.abc import Callable, Collection, Mapping +from contextlib import AsyncExitStack +from io import IOBase +from ipaddress import IPv4Address, IPv6Address +from socket import AddressFamily +from types import TracebackType +from typing import Any, TypeVar, Union + +from .._core._typedattr import ( + TypedAttributeProvider, + TypedAttributeSet, + typed_attribute, +) +from ._streams import ByteStream, Listener, UnreliableObjectStream +from ._tasks import TaskGroup + +IPAddressType = Union[str, IPv4Address, IPv6Address] +IPSockAddrType = tuple[str, int] +SockAddrType = Union[IPSockAddrType, str] +UDPPacketType = tuple[bytes, IPSockAddrType] +UNIXDatagramPacketType = tuple[bytes, str] +T_Retval = TypeVar("T_Retval") + + +class _NullAsyncContextManager: + async def __aenter__(self) -> None: + pass + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + return None + + +class SocketAttribute(TypedAttributeSet): + #: the address family of the underlying socket + family: AddressFamily = typed_attribute() + #: the local socket address of the underlying socket + local_address: SockAddrType = typed_attribute() + #: for IP addresses, the local port the underlying socket is bound to + local_port: int = typed_attribute() + #: the underlying stdlib socket object + raw_socket: socket.socket = typed_attribute() + #: the remote address the underlying socket is connected to + remote_address: SockAddrType = typed_attribute() + #: for IP addresses, the remote port the underlying socket is connected to + remote_port: int = typed_attribute() + + +class _SocketProvider(TypedAttributeProvider): + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + from .._core._sockets import convert_ipv6_sockaddr as convert + + attributes: dict[Any, Callable[[], Any]] = { + SocketAttribute.family: lambda: self._raw_socket.family, + SocketAttribute.local_address: lambda: convert( + self._raw_socket.getsockname() + ), + SocketAttribute.raw_socket: lambda: self._raw_socket, + } + try: + peername: tuple[str, int] | None = convert(self._raw_socket.getpeername()) + except OSError: + peername = None + + # Provide the remote address for connected sockets + if peername is not None: + attributes[SocketAttribute.remote_address] = lambda: peername + + # Provide local and remote ports for IP based sockets + if self._raw_socket.family in (AddressFamily.AF_INET, AddressFamily.AF_INET6): + attributes[SocketAttribute.local_port] = ( + lambda: self._raw_socket.getsockname()[1] + ) + if peername is not None: + remote_port = peername[1] + attributes[SocketAttribute.remote_port] = lambda: remote_port + + return attributes + + @property + @abstractmethod + def _raw_socket(self) -> socket.socket: + pass + + +class SocketStream(ByteStream, _SocketProvider): + """ + Transports bytes over a socket. + + Supports all relevant extra attributes from :class:`~SocketAttribute`. + """ + + +class UNIXSocketStream(SocketStream): + @abstractmethod + async def send_fds(self, message: bytes, fds: Collection[int | IOBase]) -> None: + """ + Send file descriptors along with a message to the peer. + + :param message: a non-empty bytestring + :param fds: a collection of files (either numeric file descriptors or open file + or socket objects) + """ + + @abstractmethod + async def receive_fds(self, msglen: int, maxfds: int) -> tuple[bytes, list[int]]: + """ + Receive file descriptors along with a message from the peer. + + :param msglen: length of the message to expect from the peer + :param maxfds: maximum number of file descriptors to expect from the peer + :return: a tuple of (message, file descriptors) + """ + + +class SocketListener(Listener[SocketStream], _SocketProvider): + """ + Listens to incoming socket connections. + + Supports all relevant extra attributes from :class:`~SocketAttribute`. + """ + + @abstractmethod + async def accept(self) -> SocketStream: + """Accept an incoming connection.""" + + async def serve( + self, + handler: Callable[[SocketStream], Any], + task_group: TaskGroup | None = None, + ) -> None: + from .. import create_task_group + + async with AsyncExitStack() as stack: + if task_group is None: + task_group = await stack.enter_async_context(create_task_group()) + + while True: + stream = await self.accept() + task_group.start_soon(handler, stream) + + +class UDPSocket(UnreliableObjectStream[UDPPacketType], _SocketProvider): + """ + Represents an unconnected UDP socket. + + Supports all relevant extra attributes from :class:`~SocketAttribute`. + """ + + async def sendto(self, data: bytes, host: str, port: int) -> None: + """ + Alias for :meth:`~.UnreliableObjectSendStream.send` ((data, (host, port))). + + """ + return await self.send((data, (host, port))) + + +class ConnectedUDPSocket(UnreliableObjectStream[bytes], _SocketProvider): + """ + Represents an connected UDP socket. + + Supports all relevant extra attributes from :class:`~SocketAttribute`. + """ + + +class UNIXDatagramSocket( + UnreliableObjectStream[UNIXDatagramPacketType], _SocketProvider +): + """ + Represents an unconnected Unix datagram socket. + + Supports all relevant extra attributes from :class:`~SocketAttribute`. + """ + + async def sendto(self, data: bytes, path: str) -> None: + """Alias for :meth:`~.UnreliableObjectSendStream.send` ((data, path)).""" + return await self.send((data, path)) + + +class ConnectedUNIXDatagramSocket(UnreliableObjectStream[bytes], _SocketProvider): + """ + Represents a connected Unix datagram socket. + + Supports all relevant extra attributes from :class:`~SocketAttribute`. + """ diff --git a/.venv/Lib/site-packages/anyio/abc/_streams.py b/.venv/Lib/site-packages/anyio/abc/_streams.py new file mode 100644 index 0000000..f11d97b --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/_streams.py @@ -0,0 +1,203 @@ +from __future__ import annotations + +from abc import abstractmethod +from collections.abc import Callable +from typing import Any, Generic, TypeVar, Union + +from .._core._exceptions import EndOfStream +from .._core._typedattr import TypedAttributeProvider +from ._resources import AsyncResource +from ._tasks import TaskGroup + +T_Item = TypeVar("T_Item") +T_co = TypeVar("T_co", covariant=True) +T_contra = TypeVar("T_contra", contravariant=True) + + +class UnreliableObjectReceiveStream( + Generic[T_co], AsyncResource, TypedAttributeProvider +): + """ + An interface for receiving objects. + + This interface makes no guarantees that the received messages arrive in the order in + which they were sent, or that no messages are missed. + + Asynchronously iterating over objects of this type will yield objects matching the + given type parameter. + """ + + def __aiter__(self) -> UnreliableObjectReceiveStream[T_co]: + return self + + async def __anext__(self) -> T_co: + try: + return await self.receive() + except EndOfStream: + raise StopAsyncIteration + + @abstractmethod + async def receive(self) -> T_co: + """ + Receive the next item. + + :raises ~anyio.ClosedResourceError: if the receive stream has been explicitly + closed + :raises ~anyio.EndOfStream: if this stream has been closed from the other end + :raises ~anyio.BrokenResourceError: if this stream has been rendered unusable + due to external causes + """ + + +class UnreliableObjectSendStream( + Generic[T_contra], AsyncResource, TypedAttributeProvider +): + """ + An interface for sending objects. + + This interface makes no guarantees that the messages sent will reach the + recipient(s) in the same order in which they were sent, or at all. + """ + + @abstractmethod + async def send(self, item: T_contra) -> None: + """ + Send an item to the peer(s). + + :param item: the item to send + :raises ~anyio.ClosedResourceError: if the send stream has been explicitly + closed + :raises ~anyio.BrokenResourceError: if this stream has been rendered unusable + due to external causes + """ + + +class UnreliableObjectStream( + UnreliableObjectReceiveStream[T_Item], UnreliableObjectSendStream[T_Item] +): + """ + A bidirectional message stream which does not guarantee the order or reliability of + message delivery. + """ + + +class ObjectReceiveStream(UnreliableObjectReceiveStream[T_co]): + """ + A receive message stream which guarantees that messages are received in the same + order in which they were sent, and that no messages are missed. + """ + + +class ObjectSendStream(UnreliableObjectSendStream[T_contra]): + """ + A send message stream which guarantees that messages are delivered in the same order + in which they were sent, without missing any messages in the middle. + """ + + +class ObjectStream( + ObjectReceiveStream[T_Item], + ObjectSendStream[T_Item], + UnreliableObjectStream[T_Item], +): + """ + A bidirectional message stream which guarantees the order and reliability of message + delivery. + """ + + @abstractmethod + async def send_eof(self) -> None: + """ + Send an end-of-file indication to the peer. + + You should not try to send any further data to this stream after calling this + method. This method is idempotent (does nothing on successive calls). + """ + + +class ByteReceiveStream(AsyncResource, TypedAttributeProvider): + """ + An interface for receiving bytes from a single peer. + + Iterating this byte stream will yield a byte string of arbitrary length, but no more + than 65536 bytes. + """ + + def __aiter__(self) -> ByteReceiveStream: + return self + + async def __anext__(self) -> bytes: + try: + return await self.receive() + except EndOfStream: + raise StopAsyncIteration + + @abstractmethod + async def receive(self, max_bytes: int = 65536) -> bytes: + """ + Receive at most ``max_bytes`` bytes from the peer. + + .. note:: Implementers of this interface should not return an empty + :class:`bytes` object, and users should ignore them. + + :param max_bytes: maximum number of bytes to receive + :return: the received bytes + :raises ~anyio.EndOfStream: if this stream has been closed from the other end + """ + + +class ByteSendStream(AsyncResource, TypedAttributeProvider): + """An interface for sending bytes to a single peer.""" + + @abstractmethod + async def send(self, item: bytes) -> None: + """ + Send the given bytes to the peer. + + :param item: the bytes to send + """ + + +class ByteStream(ByteReceiveStream, ByteSendStream): + """A bidirectional byte stream.""" + + @abstractmethod + async def send_eof(self) -> None: + """ + Send an end-of-file indication to the peer. + + You should not try to send any further data to this stream after calling this + method. This method is idempotent (does nothing on successive calls). + """ + + +#: Type alias for all unreliable bytes-oriented receive streams. +AnyUnreliableByteReceiveStream = Union[ + UnreliableObjectReceiveStream[bytes], ByteReceiveStream +] +#: Type alias for all unreliable bytes-oriented send streams. +AnyUnreliableByteSendStream = Union[UnreliableObjectSendStream[bytes], ByteSendStream] +#: Type alias for all unreliable bytes-oriented streams. +AnyUnreliableByteStream = Union[UnreliableObjectStream[bytes], ByteStream] +#: Type alias for all bytes-oriented receive streams. +AnyByteReceiveStream = Union[ObjectReceiveStream[bytes], ByteReceiveStream] +#: Type alias for all bytes-oriented send streams. +AnyByteSendStream = Union[ObjectSendStream[bytes], ByteSendStream] +#: Type alias for all bytes-oriented streams. +AnyByteStream = Union[ObjectStream[bytes], ByteStream] + + +class Listener(Generic[T_co], AsyncResource, TypedAttributeProvider): + """An interface for objects that let you accept incoming connections.""" + + @abstractmethod + async def serve( + self, handler: Callable[[T_co], Any], task_group: TaskGroup | None = None + ) -> None: + """ + Accept incoming connections as they come in and start tasks to handle them. + + :param handler: a callable that will be used to handle each accepted connection + :param task_group: the task group that will be used to start tasks for handling + each accepted connection (if omitted, an ad-hoc task group will be created) + """ diff --git a/.venv/Lib/site-packages/anyio/abc/_subprocesses.py b/.venv/Lib/site-packages/anyio/abc/_subprocesses.py new file mode 100644 index 0000000..ce0564c --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/_subprocesses.py @@ -0,0 +1,79 @@ +from __future__ import annotations + +from abc import abstractmethod +from signal import Signals + +from ._resources import AsyncResource +from ._streams import ByteReceiveStream, ByteSendStream + + +class Process(AsyncResource): + """An asynchronous version of :class:`subprocess.Popen`.""" + + @abstractmethod + async def wait(self) -> int: + """ + Wait until the process exits. + + :return: the exit code of the process + """ + + @abstractmethod + def terminate(self) -> None: + """ + Terminates the process, gracefully if possible. + + On Windows, this calls ``TerminateProcess()``. + On POSIX systems, this sends ``SIGTERM`` to the process. + + .. seealso:: :meth:`subprocess.Popen.terminate` + """ + + @abstractmethod + def kill(self) -> None: + """ + Kills the process. + + On Windows, this calls ``TerminateProcess()``. + On POSIX systems, this sends ``SIGKILL`` to the process. + + .. seealso:: :meth:`subprocess.Popen.kill` + """ + + @abstractmethod + def send_signal(self, signal: Signals) -> None: + """ + Send a signal to the subprocess. + + .. seealso:: :meth:`subprocess.Popen.send_signal` + + :param signal: the signal number (e.g. :data:`signal.SIGHUP`) + """ + + @property + @abstractmethod + def pid(self) -> int: + """The process ID of the process.""" + + @property + @abstractmethod + def returncode(self) -> int | None: + """ + The return code of the process. If the process has not yet terminated, this will + be ``None``. + """ + + @property + @abstractmethod + def stdin(self) -> ByteSendStream | None: + """The stream for the standard input of the process.""" + + @property + @abstractmethod + def stdout(self) -> ByteReceiveStream | None: + """The stream for the standard output of the process.""" + + @property + @abstractmethod + def stderr(self) -> ByteReceiveStream | None: + """The stream for the standard error output of the process.""" diff --git a/.venv/Lib/site-packages/anyio/abc/_tasks.py b/.venv/Lib/site-packages/anyio/abc/_tasks.py new file mode 100644 index 0000000..f6e5c40 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/_tasks.py @@ -0,0 +1,101 @@ +from __future__ import annotations + +import sys +from abc import ABCMeta, abstractmethod +from collections.abc import Awaitable, Callable +from types import TracebackType +from typing import TYPE_CHECKING, Any, Protocol, TypeVar, overload + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +if TYPE_CHECKING: + from .._core._tasks import CancelScope + +T_Retval = TypeVar("T_Retval") +T_contra = TypeVar("T_contra", contravariant=True) +PosArgsT = TypeVarTuple("PosArgsT") + + +class TaskStatus(Protocol[T_contra]): + @overload + def started(self: TaskStatus[None]) -> None: ... + + @overload + def started(self, value: T_contra) -> None: ... + + def started(self, value: T_contra | None = None) -> None: + """ + Signal that the task has started. + + :param value: object passed back to the starter of the task + """ + + +class TaskGroup(metaclass=ABCMeta): + """ + Groups several asynchronous tasks together. + + :ivar cancel_scope: the cancel scope inherited by all child tasks + :vartype cancel_scope: CancelScope + + .. note:: On asyncio, support for eager task factories is considered to be + **experimental**. In particular, they don't follow the usual semantics of new + tasks being scheduled on the next iteration of the event loop, and may thus + cause unexpected behavior in code that wasn't written with such semantics in + mind. + """ + + cancel_scope: CancelScope + + @abstractmethod + def start_soon( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[Any]], + *args: Unpack[PosArgsT], + name: object = None, + ) -> None: + """ + Start a new task in this task group. + + :param func: a coroutine function + :param args: positional arguments to call the function with + :param name: name of the task, for the purposes of introspection and debugging + + .. versionadded:: 3.0 + """ + + @abstractmethod + async def start( + self, + func: Callable[..., Awaitable[Any]], + *args: object, + name: object = None, + ) -> Any: + """ + Start a new task and wait until it signals for readiness. + + :param func: a coroutine function + :param args: positional arguments to call the function with + :param name: name of the task, for the purposes of introspection and debugging + :return: the value passed to ``task_status.started()`` + :raises RuntimeError: if the task finishes without calling + ``task_status.started()`` + + .. versionadded:: 3.0 + """ + + @abstractmethod + async def __aenter__(self) -> TaskGroup: + """Enter the task group context and allow starting new tasks.""" + + @abstractmethod + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + """Exit the task group context waiting for all tasks to finish.""" diff --git a/.venv/Lib/site-packages/anyio/abc/_testing.py b/.venv/Lib/site-packages/anyio/abc/_testing.py new file mode 100644 index 0000000..7c50ed7 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/abc/_testing.py @@ -0,0 +1,65 @@ +from __future__ import annotations + +import types +from abc import ABCMeta, abstractmethod +from collections.abc import AsyncGenerator, Callable, Coroutine, Iterable +from typing import Any, TypeVar + +_T = TypeVar("_T") + + +class TestRunner(metaclass=ABCMeta): + """ + Encapsulates a running event loop. Every call made through this object will use the + same event loop. + """ + + def __enter__(self) -> TestRunner: + return self + + @abstractmethod + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: types.TracebackType | None, + ) -> bool | None: ... + + @abstractmethod + def run_asyncgen_fixture( + self, + fixture_func: Callable[..., AsyncGenerator[_T, Any]], + kwargs: dict[str, Any], + ) -> Iterable[_T]: + """ + Run an async generator fixture. + + :param fixture_func: the fixture function + :param kwargs: keyword arguments to call the fixture function with + :return: an iterator yielding the value yielded from the async generator + """ + + @abstractmethod + def run_fixture( + self, + fixture_func: Callable[..., Coroutine[Any, Any, _T]], + kwargs: dict[str, Any], + ) -> _T: + """ + Run an async fixture. + + :param fixture_func: the fixture function + :param kwargs: keyword arguments to call the fixture function with + :return: the return value of the fixture function + """ + + @abstractmethod + def run_test( + self, test_func: Callable[..., Coroutine[Any, Any, Any]], kwargs: dict[str, Any] + ) -> None: + """ + Run an async test function. + + :param test_func: the test function + :param kwargs: keyword arguments to call the test function with + """ diff --git a/.venv/Lib/site-packages/anyio/from_thread.py b/.venv/Lib/site-packages/anyio/from_thread.py new file mode 100644 index 0000000..6179097 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/from_thread.py @@ -0,0 +1,527 @@ +from __future__ import annotations + +import sys +from collections.abc import Awaitable, Callable, Generator +from concurrent.futures import Future +from contextlib import ( + AbstractAsyncContextManager, + AbstractContextManager, + contextmanager, +) +from dataclasses import dataclass, field +from inspect import isawaitable +from threading import Lock, Thread, get_ident +from types import TracebackType +from typing import ( + Any, + Generic, + TypeVar, + cast, + overload, +) + +from ._core import _eventloop +from ._core._eventloop import get_async_backend, get_cancelled_exc_class, threadlocals +from ._core._synchronization import Event +from ._core._tasks import CancelScope, create_task_group +from .abc import AsyncBackend +from .abc._tasks import TaskStatus + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +T_Retval = TypeVar("T_Retval") +T_co = TypeVar("T_co", covariant=True) +PosArgsT = TypeVarTuple("PosArgsT") + + +def run( + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], *args: Unpack[PosArgsT] +) -> T_Retval: + """ + Call a coroutine function from a worker thread. + + :param func: a coroutine function + :param args: positional arguments for the callable + :return: the return value of the coroutine function + + """ + try: + async_backend = threadlocals.current_async_backend + token = threadlocals.current_token + except AttributeError: + raise RuntimeError( + "This function can only be run from an AnyIO worker thread" + ) from None + + return async_backend.run_async_from_thread(func, args, token=token) + + +def run_sync( + func: Callable[[Unpack[PosArgsT]], T_Retval], *args: Unpack[PosArgsT] +) -> T_Retval: + """ + Call a function in the event loop thread from a worker thread. + + :param func: a callable + :param args: positional arguments for the callable + :return: the return value of the callable + + """ + try: + async_backend = threadlocals.current_async_backend + token = threadlocals.current_token + except AttributeError: + raise RuntimeError( + "This function can only be run from an AnyIO worker thread" + ) from None + + return async_backend.run_sync_from_thread(func, args, token=token) + + +class _BlockingAsyncContextManager(Generic[T_co], AbstractContextManager): + _enter_future: Future[T_co] + _exit_future: Future[bool | None] + _exit_event: Event + _exit_exc_info: tuple[ + type[BaseException] | None, BaseException | None, TracebackType | None + ] = (None, None, None) + + def __init__( + self, async_cm: AbstractAsyncContextManager[T_co], portal: BlockingPortal + ): + self._async_cm = async_cm + self._portal = portal + + async def run_async_cm(self) -> bool | None: + try: + self._exit_event = Event() + value = await self._async_cm.__aenter__() + except BaseException as exc: + self._enter_future.set_exception(exc) + raise + else: + self._enter_future.set_result(value) + + try: + # Wait for the sync context manager to exit. + # This next statement can raise `get_cancelled_exc_class()` if + # something went wrong in a task group in this async context + # manager. + await self._exit_event.wait() + finally: + # In case of cancellation, it could be that we end up here before + # `_BlockingAsyncContextManager.__exit__` is called, and an + # `_exit_exc_info` has been set. + result = await self._async_cm.__aexit__(*self._exit_exc_info) + return result + + def __enter__(self) -> T_co: + self._enter_future = Future() + self._exit_future = self._portal.start_task_soon(self.run_async_cm) + return self._enter_future.result() + + def __exit__( + self, + __exc_type: type[BaseException] | None, + __exc_value: BaseException | None, + __traceback: TracebackType | None, + ) -> bool | None: + self._exit_exc_info = __exc_type, __exc_value, __traceback + self._portal.call(self._exit_event.set) + return self._exit_future.result() + + +class _BlockingPortalTaskStatus(TaskStatus): + def __init__(self, future: Future): + self._future = future + + def started(self, value: object = None) -> None: + self._future.set_result(value) + + +class BlockingPortal: + """An object that lets external threads run code in an asynchronous event loop.""" + + def __new__(cls) -> BlockingPortal: + return get_async_backend().create_blocking_portal() + + def __init__(self) -> None: + self._event_loop_thread_id: int | None = get_ident() + self._stop_event = Event() + self._task_group = create_task_group() + self._cancelled_exc_class = get_cancelled_exc_class() + + async def __aenter__(self) -> BlockingPortal: + await self._task_group.__aenter__() + return self + + async def __aexit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> bool | None: + await self.stop() + return await self._task_group.__aexit__(exc_type, exc_val, exc_tb) + + def _check_running(self) -> None: + if self._event_loop_thread_id is None: + raise RuntimeError("This portal is not running") + if self._event_loop_thread_id == get_ident(): + raise RuntimeError( + "This method cannot be called from the event loop thread" + ) + + async def sleep_until_stopped(self) -> None: + """Sleep until :meth:`stop` is called.""" + await self._stop_event.wait() + + async def stop(self, cancel_remaining: bool = False) -> None: + """ + Signal the portal to shut down. + + This marks the portal as no longer accepting new calls and exits from + :meth:`sleep_until_stopped`. + + :param cancel_remaining: ``True`` to cancel all the remaining tasks, ``False`` + to let them finish before returning + + """ + self._event_loop_thread_id = None + self._stop_event.set() + if cancel_remaining: + self._task_group.cancel_scope.cancel() + + async def _call_func( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + future: Future[T_Retval], + ) -> None: + def callback(f: Future[T_Retval]) -> None: + if f.cancelled() and self._event_loop_thread_id not in ( + None, + get_ident(), + ): + self.call(scope.cancel) + + try: + retval_or_awaitable = func(*args, **kwargs) + if isawaitable(retval_or_awaitable): + with CancelScope() as scope: + if future.cancelled(): + scope.cancel() + else: + future.add_done_callback(callback) + + retval = await retval_or_awaitable + else: + retval = retval_or_awaitable + except self._cancelled_exc_class: + future.cancel() + future.set_running_or_notify_cancel() + except BaseException as exc: + if not future.cancelled(): + future.set_exception(exc) + + # Let base exceptions fall through + if not isinstance(exc, Exception): + raise + else: + if not future.cancelled(): + future.set_result(retval) + finally: + scope = None # type: ignore[assignment] + + def _spawn_task_from_thread( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval], + args: tuple[Unpack[PosArgsT]], + kwargs: dict[str, Any], + name: object, + future: Future[T_Retval], + ) -> None: + """ + Spawn a new task using the given callable. + + Implementers must ensure that the future is resolved when the task finishes. + + :param func: a callable + :param args: positional arguments to be passed to the callable + :param kwargs: keyword arguments to be passed to the callable + :param name: name of the task (will be coerced to a string if not ``None``) + :param future: a future that will resolve to the return value of the callable, + or the exception raised during its execution + + """ + raise NotImplementedError + + @overload + def call( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + *args: Unpack[PosArgsT], + ) -> T_Retval: ... + + @overload + def call( + self, func: Callable[[Unpack[PosArgsT]], T_Retval], *args: Unpack[PosArgsT] + ) -> T_Retval: ... + + def call( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval], + *args: Unpack[PosArgsT], + ) -> T_Retval: + """ + Call the given function in the event loop thread. + + If the callable returns a coroutine object, it is awaited on. + + :param func: any callable + :raises RuntimeError: if the portal is not running or if this method is called + from within the event loop thread + + """ + return cast(T_Retval, self.start_task_soon(func, *args).result()) + + @overload + def start_task_soon( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval]], + *args: Unpack[PosArgsT], + name: object = None, + ) -> Future[T_Retval]: ... + + @overload + def start_task_soon( + self, + func: Callable[[Unpack[PosArgsT]], T_Retval], + *args: Unpack[PosArgsT], + name: object = None, + ) -> Future[T_Retval]: ... + + def start_task_soon( + self, + func: Callable[[Unpack[PosArgsT]], Awaitable[T_Retval] | T_Retval], + *args: Unpack[PosArgsT], + name: object = None, + ) -> Future[T_Retval]: + """ + Start a task in the portal's task group. + + The task will be run inside a cancel scope which can be cancelled by cancelling + the returned future. + + :param func: the target function + :param args: positional arguments passed to ``func`` + :param name: name of the task (will be coerced to a string if not ``None``) + :return: a future that resolves with the return value of the callable if the + task completes successfully, or with the exception raised in the task + :raises RuntimeError: if the portal is not running or if this method is called + from within the event loop thread + :rtype: concurrent.futures.Future[T_Retval] + + .. versionadded:: 3.0 + + """ + self._check_running() + f: Future[T_Retval] = Future() + self._spawn_task_from_thread(func, args, {}, name, f) + return f + + def start_task( + self, + func: Callable[..., Awaitable[T_Retval]], + *args: object, + name: object = None, + ) -> tuple[Future[T_Retval], Any]: + """ + Start a task in the portal's task group and wait until it signals for readiness. + + This method works the same way as :meth:`.abc.TaskGroup.start`. + + :param func: the target function + :param args: positional arguments passed to ``func`` + :param name: name of the task (will be coerced to a string if not ``None``) + :return: a tuple of (future, task_status_value) where the ``task_status_value`` + is the value passed to ``task_status.started()`` from within the target + function + :rtype: tuple[concurrent.futures.Future[T_Retval], Any] + + .. versionadded:: 3.0 + + """ + + def task_done(future: Future[T_Retval]) -> None: + if not task_status_future.done(): + if future.cancelled(): + task_status_future.cancel() + elif future.exception(): + task_status_future.set_exception(future.exception()) + else: + exc = RuntimeError( + "Task exited without calling task_status.started()" + ) + task_status_future.set_exception(exc) + + self._check_running() + task_status_future: Future = Future() + task_status = _BlockingPortalTaskStatus(task_status_future) + f: Future = Future() + f.add_done_callback(task_done) + self._spawn_task_from_thread(func, args, {"task_status": task_status}, name, f) + return f, task_status_future.result() + + def wrap_async_context_manager( + self, cm: AbstractAsyncContextManager[T_co] + ) -> AbstractContextManager[T_co]: + """ + Wrap an async context manager as a synchronous context manager via this portal. + + Spawns a task that will call both ``__aenter__()`` and ``__aexit__()``, stopping + in the middle until the synchronous context manager exits. + + :param cm: an asynchronous context manager + :return: a synchronous context manager + + .. versionadded:: 2.1 + + """ + return _BlockingAsyncContextManager(cm, self) + + +@dataclass +class BlockingPortalProvider: + """ + A manager for a blocking portal. Used as a context manager. The first thread to + enter this context manager causes a blocking portal to be started with the specific + parameters, and the last thread to exit causes the portal to be shut down. Thus, + there will be exactly one blocking portal running in this context as long as at + least one thread has entered this context manager. + + The parameters are the same as for :func:`~anyio.run`. + + :param backend: name of the backend + :param backend_options: backend options + + .. versionadded:: 4.4 + """ + + backend: str = "asyncio" + backend_options: dict[str, Any] | None = None + _lock: Lock = field(init=False, default_factory=Lock) + _leases: int = field(init=False, default=0) + _portal: BlockingPortal = field(init=False) + _portal_cm: AbstractContextManager[BlockingPortal] | None = field( + init=False, default=None + ) + + def __enter__(self) -> BlockingPortal: + with self._lock: + if self._portal_cm is None: + self._portal_cm = start_blocking_portal( + self.backend, self.backend_options + ) + self._portal = self._portal_cm.__enter__() + + self._leases += 1 + return self._portal + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + portal_cm: AbstractContextManager[BlockingPortal] | None = None + with self._lock: + assert self._portal_cm + assert self._leases > 0 + self._leases -= 1 + if not self._leases: + portal_cm = self._portal_cm + self._portal_cm = None + del self._portal + + if portal_cm: + portal_cm.__exit__(None, None, None) + + +@contextmanager +def start_blocking_portal( + backend: str = "asyncio", backend_options: dict[str, Any] | None = None +) -> Generator[BlockingPortal, Any, None]: + """ + Start a new event loop in a new thread and run a blocking portal in its main task. + + The parameters are the same as for :func:`~anyio.run`. + + :param backend: name of the backend + :param backend_options: backend options + :return: a context manager that yields a blocking portal + + .. versionchanged:: 3.0 + Usage as a context manager is now required. + + """ + + async def run_portal() -> None: + async with BlockingPortal() as portal_: + future.set_result(portal_) + await portal_.sleep_until_stopped() + + def run_blocking_portal() -> None: + if future.set_running_or_notify_cancel(): + try: + _eventloop.run( + run_portal, backend=backend, backend_options=backend_options + ) + except BaseException as exc: + if not future.done(): + future.set_exception(exc) + + future: Future[BlockingPortal] = Future() + thread = Thread(target=run_blocking_portal, daemon=True) + thread.start() + try: + cancel_remaining_tasks = False + portal = future.result() + try: + yield portal + except BaseException: + cancel_remaining_tasks = True + raise + finally: + try: + portal.call(portal.stop, cancel_remaining_tasks) + except RuntimeError: + pass + finally: + thread.join() + + +def check_cancelled() -> None: + """ + Check if the cancel scope of the host task's running the current worker thread has + been cancelled. + + If the host task's current cancel scope has indeed been cancelled, the + backend-specific cancellation exception will be raised. + + :raises RuntimeError: if the current thread was not spawned by + :func:`.to_thread.run_sync` + + """ + try: + async_backend: AsyncBackend = threadlocals.current_async_backend + except AttributeError: + raise RuntimeError( + "This function can only be run from an AnyIO worker thread" + ) from None + + async_backend.check_cancelled() diff --git a/.venv/Lib/site-packages/anyio/lowlevel.py b/.venv/Lib/site-packages/anyio/lowlevel.py new file mode 100644 index 0000000..14c7668 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/lowlevel.py @@ -0,0 +1,161 @@ +from __future__ import annotations + +import enum +from dataclasses import dataclass +from typing import Any, Generic, Literal, TypeVar, overload +from weakref import WeakKeyDictionary + +from ._core._eventloop import get_async_backend + +T = TypeVar("T") +D = TypeVar("D") + + +async def checkpoint() -> None: + """ + Check for cancellation and allow the scheduler to switch to another task. + + Equivalent to (but more efficient than):: + + await checkpoint_if_cancelled() + await cancel_shielded_checkpoint() + + + .. versionadded:: 3.0 + + """ + await get_async_backend().checkpoint() + + +async def checkpoint_if_cancelled() -> None: + """ + Enter a checkpoint if the enclosing cancel scope has been cancelled. + + This does not allow the scheduler to switch to a different task. + + .. versionadded:: 3.0 + + """ + await get_async_backend().checkpoint_if_cancelled() + + +async def cancel_shielded_checkpoint() -> None: + """ + Allow the scheduler to switch to another task but without checking for cancellation. + + Equivalent to (but potentially more efficient than):: + + with CancelScope(shield=True): + await checkpoint() + + + .. versionadded:: 3.0 + + """ + await get_async_backend().cancel_shielded_checkpoint() + + +def current_token() -> object: + """ + Return a backend specific token object that can be used to get back to the event + loop. + + """ + return get_async_backend().current_token() + + +_run_vars: WeakKeyDictionary[Any, dict[str, Any]] = WeakKeyDictionary() +_token_wrappers: dict[Any, _TokenWrapper] = {} + + +@dataclass(frozen=True) +class _TokenWrapper: + __slots__ = "_token", "__weakref__" + _token: object + + +class _NoValueSet(enum.Enum): + NO_VALUE_SET = enum.auto() + + +class RunvarToken(Generic[T]): + __slots__ = "_var", "_value", "_redeemed" + + def __init__(self, var: RunVar[T], value: T | Literal[_NoValueSet.NO_VALUE_SET]): + self._var = var + self._value: T | Literal[_NoValueSet.NO_VALUE_SET] = value + self._redeemed = False + + +class RunVar(Generic[T]): + """ + Like a :class:`~contextvars.ContextVar`, except scoped to the running event loop. + """ + + __slots__ = "_name", "_default" + + NO_VALUE_SET: Literal[_NoValueSet.NO_VALUE_SET] = _NoValueSet.NO_VALUE_SET + + _token_wrappers: set[_TokenWrapper] = set() + + def __init__( + self, name: str, default: T | Literal[_NoValueSet.NO_VALUE_SET] = NO_VALUE_SET + ): + self._name = name + self._default = default + + @property + def _current_vars(self) -> dict[str, T]: + token = current_token() + try: + return _run_vars[token] + except KeyError: + run_vars = _run_vars[token] = {} + return run_vars + + @overload + def get(self, default: D) -> T | D: ... + + @overload + def get(self) -> T: ... + + def get( + self, default: D | Literal[_NoValueSet.NO_VALUE_SET] = NO_VALUE_SET + ) -> T | D: + try: + return self._current_vars[self._name] + except KeyError: + if default is not RunVar.NO_VALUE_SET: + return default + elif self._default is not RunVar.NO_VALUE_SET: + return self._default + + raise LookupError( + f'Run variable "{self._name}" has no value and no default set' + ) + + def set(self, value: T) -> RunvarToken[T]: + current_vars = self._current_vars + token = RunvarToken(self, current_vars.get(self._name, RunVar.NO_VALUE_SET)) + current_vars[self._name] = value + return token + + def reset(self, token: RunvarToken[T]) -> None: + if token._var is not self: + raise ValueError("This token does not belong to this RunVar") + + if token._redeemed: + raise ValueError("This token has already been used") + + if token._value is _NoValueSet.NO_VALUE_SET: + try: + del self._current_vars[self._name] + except KeyError: + pass + else: + self._current_vars[self._name] = token._value + + token._redeemed = True + + def __repr__(self) -> str: + return f"" diff --git a/.venv/Lib/site-packages/anyio/py.typed b/.venv/Lib/site-packages/anyio/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/anyio/pytest_plugin.py b/.venv/Lib/site-packages/anyio/pytest_plugin.py new file mode 100644 index 0000000..21e4ab2 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/pytest_plugin.py @@ -0,0 +1,272 @@ +from __future__ import annotations + +import socket +import sys +from collections.abc import Callable, Generator, Iterator +from contextlib import ExitStack, contextmanager +from inspect import isasyncgenfunction, iscoroutinefunction, ismethod +from typing import Any, cast + +import pytest +import sniffio +from _pytest.fixtures import SubRequest +from _pytest.outcomes import Exit + +from ._core._eventloop import get_all_backends, get_async_backend +from ._core._exceptions import iterate_exceptions +from .abc import TestRunner + +if sys.version_info < (3, 11): + from exceptiongroup import ExceptionGroup + +_current_runner: TestRunner | None = None +_runner_stack: ExitStack | None = None +_runner_leases = 0 + + +def extract_backend_and_options(backend: object) -> tuple[str, dict[str, Any]]: + if isinstance(backend, str): + return backend, {} + elif isinstance(backend, tuple) and len(backend) == 2: + if isinstance(backend[0], str) and isinstance(backend[1], dict): + return cast(tuple[str, dict[str, Any]], backend) + + raise TypeError("anyio_backend must be either a string or tuple of (string, dict)") + + +@contextmanager +def get_runner( + backend_name: str, backend_options: dict[str, Any] +) -> Iterator[TestRunner]: + global _current_runner, _runner_leases, _runner_stack + if _current_runner is None: + asynclib = get_async_backend(backend_name) + _runner_stack = ExitStack() + if sniffio.current_async_library_cvar.get(None) is None: + # Since we're in control of the event loop, we can cache the name of the + # async library + token = sniffio.current_async_library_cvar.set(backend_name) + _runner_stack.callback(sniffio.current_async_library_cvar.reset, token) + + backend_options = backend_options or {} + _current_runner = _runner_stack.enter_context( + asynclib.create_test_runner(backend_options) + ) + + _runner_leases += 1 + try: + yield _current_runner + finally: + _runner_leases -= 1 + if not _runner_leases: + assert _runner_stack is not None + _runner_stack.close() + _runner_stack = _current_runner = None + + +def pytest_configure(config: Any) -> None: + config.addinivalue_line( + "markers", + "anyio: mark the (coroutine function) test to be run asynchronously via anyio.", + ) + + +@pytest.hookimpl(hookwrapper=True) +def pytest_fixture_setup(fixturedef: Any, request: Any) -> Generator[Any]: + def wrapper( + *args: Any, anyio_backend: Any, request: SubRequest, **kwargs: Any + ) -> Any: + # Rebind any fixture methods to the request instance + if ( + request.instance + and ismethod(func) + and type(func.__self__) is type(request.instance) + ): + local_func = func.__func__.__get__(request.instance) + else: + local_func = func + + backend_name, backend_options = extract_backend_and_options(anyio_backend) + if has_backend_arg: + kwargs["anyio_backend"] = anyio_backend + + if has_request_arg: + kwargs["request"] = request + + with get_runner(backend_name, backend_options) as runner: + if isasyncgenfunction(local_func): + yield from runner.run_asyncgen_fixture(local_func, kwargs) + else: + yield runner.run_fixture(local_func, kwargs) + + # Only apply this to coroutine functions and async generator functions in requests + # that involve the anyio_backend fixture + func = fixturedef.func + if isasyncgenfunction(func) or iscoroutinefunction(func): + if "anyio_backend" in request.fixturenames: + fixturedef.func = wrapper + original_argname = fixturedef.argnames + + if not (has_backend_arg := "anyio_backend" in fixturedef.argnames): + fixturedef.argnames += ("anyio_backend",) + + if not (has_request_arg := "request" in fixturedef.argnames): + fixturedef.argnames += ("request",) + + try: + return (yield) + finally: + fixturedef.func = func + fixturedef.argnames = original_argname + + return (yield) + + +@pytest.hookimpl(tryfirst=True) +def pytest_pycollect_makeitem(collector: Any, name: Any, obj: Any) -> None: + if collector.istestfunction(obj, name): + inner_func = obj.hypothesis.inner_test if hasattr(obj, "hypothesis") else obj + if iscoroutinefunction(inner_func): + marker = collector.get_closest_marker("anyio") + own_markers = getattr(obj, "pytestmark", ()) + if marker or any(marker.name == "anyio" for marker in own_markers): + pytest.mark.usefixtures("anyio_backend")(obj) + + +@pytest.hookimpl(tryfirst=True) +def pytest_pyfunc_call(pyfuncitem: Any) -> bool | None: + def run_with_hypothesis(**kwargs: Any) -> None: + with get_runner(backend_name, backend_options) as runner: + runner.run_test(original_func, kwargs) + + backend = pyfuncitem.funcargs.get("anyio_backend") + if backend: + backend_name, backend_options = extract_backend_and_options(backend) + + if hasattr(pyfuncitem.obj, "hypothesis"): + # Wrap the inner test function unless it's already wrapped + original_func = pyfuncitem.obj.hypothesis.inner_test + if original_func.__qualname__ != run_with_hypothesis.__qualname__: + if iscoroutinefunction(original_func): + pyfuncitem.obj.hypothesis.inner_test = run_with_hypothesis + + return None + + if iscoroutinefunction(pyfuncitem.obj): + funcargs = pyfuncitem.funcargs + testargs = {arg: funcargs[arg] for arg in pyfuncitem._fixtureinfo.argnames} + with get_runner(backend_name, backend_options) as runner: + try: + runner.run_test(pyfuncitem.obj, testargs) + except ExceptionGroup as excgrp: + for exc in iterate_exceptions(excgrp): + if isinstance(exc, (Exit, KeyboardInterrupt, SystemExit)): + raise exc from excgrp + + raise + + return True + + return None + + +@pytest.fixture(scope="module", params=get_all_backends()) +def anyio_backend(request: Any) -> Any: + return request.param + + +@pytest.fixture +def anyio_backend_name(anyio_backend: Any) -> str: + if isinstance(anyio_backend, str): + return anyio_backend + else: + return anyio_backend[0] + + +@pytest.fixture +def anyio_backend_options(anyio_backend: Any) -> dict[str, Any]: + if isinstance(anyio_backend, str): + return {} + else: + return anyio_backend[1] + + +class FreePortFactory: + """ + Manages port generation based on specified socket kind, ensuring no duplicate + ports are generated. + + This class provides functionality for generating available free ports on the + system. It is initialized with a specific socket kind and can generate ports + for given address families while avoiding reuse of previously generated ports. + + Users should not instantiate this class directly, but use the + ``free_tcp_port_factory`` and ``free_udp_port_factory`` fixtures instead. For simple + uses cases, ``free_tcp_port`` and ``free_udp_port`` can be used instead. + """ + + def __init__(self, kind: socket.SocketKind) -> None: + self._kind = kind + self._generated = set[int]() + + @property + def kind(self) -> socket.SocketKind: + """ + The type of socket connection (e.g., :data:`~socket.SOCK_STREAM` or + :data:`~socket.SOCK_DGRAM`) used to bind for checking port availability + + """ + return self._kind + + def __call__(self, family: socket.AddressFamily | None = None) -> int: + """ + Return an unbound port for the given address family. + + :param family: if omitted, both IPv4 and IPv6 addresses will be tried + :return: a port number + + """ + if family is not None: + families = [family] + else: + families = [socket.AF_INET] + if socket.has_ipv6: + families.append(socket.AF_INET6) + + while True: + port = 0 + with ExitStack() as stack: + for family in families: + sock = stack.enter_context(socket.socket(family, self._kind)) + addr = "::1" if family == socket.AF_INET6 else "127.0.0.1" + try: + sock.bind((addr, port)) + except OSError: + break + + if not port: + port = sock.getsockname()[1] + else: + if port not in self._generated: + self._generated.add(port) + return port + + +@pytest.fixture(scope="session") +def free_tcp_port_factory() -> FreePortFactory: + return FreePortFactory(socket.SOCK_STREAM) + + +@pytest.fixture(scope="session") +def free_udp_port_factory() -> FreePortFactory: + return FreePortFactory(socket.SOCK_DGRAM) + + +@pytest.fixture +def free_tcp_port(free_tcp_port_factory: Callable[[], int]) -> int: + return free_tcp_port_factory() + + +@pytest.fixture +def free_udp_port(free_udp_port_factory: Callable[[], int]) -> int: + return free_udp_port_factory() diff --git a/.venv/Lib/site-packages/anyio/streams/__init__.py b/.venv/Lib/site-packages/anyio/streams/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/anyio/streams/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/anyio/streams/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2decfb08e240a9d7d695ffab56059ef6e3e3349c GIT binary patch literal 211 zcmZ8bI|{-;5Y74l5yW#?B(YV*##SVa-N3R*hPdXl%gid|B%Z;ucmu)86G%EMH?0re zn>WMbF^}178hFf;SJBURFaPL9{&EZ2U?C3ofChf+`plPhYdA6zgVH%^hNR6-it2>S z88gRVDJ-x-QqB-mreH|DN@cCAFXd_p(G{C3>~#vP9fnqAr7F<(HLW%=J3>`+ETwL= dlQOdHbF!&TeyMOvWB-Eiq%v7_3woEUYSz;;rYVal9%C;6l! zsq7ssOQj6MaSAm}5jiO;87*oCC{P7~MIoODSKBRe5B0nT)A3A%- zJIb<@80Z2#?$7M(&g{%Lv-??fbrpi*d-?w8Z)*_x7ipNqZd9oC_n|V61SC*0N>WjZ zB6XW=OVUv~$wV2wP0MW39~dAo9d#!?QBSfuTAlPpy?Vbx z_9gvMf3hZ8Lm?Xy?Sk{J>kehCYeUZ?q3Q+_++xig+UUDu{Gn*=lqX#M6={Vj&CRD$ zX_Z%{bV>=^G-rgDWqw!|HOGtm#DtU@g-(~it9(M{6-8r5BvBS%9(_DD^_7kAV6?i3 zoK{5PoT#KTI3W&UoW@$sNl})Pk}Be}Y4ub(lM*!dP)c}d1rP9It9zy#5WUVdGtTVXi)2agvvY;QIrx;)brW$%!^Ly0;BJB&IiqXKi+X^lDs7mQYsQK43F-(aFHu}Y{DJU19i zpKj<02-O>UJVL$DAb4-E(Q2Vl@WCvv&?NZb-#1kg4r;*@nUN6@i^5~FO}}5oLHQZx zClroPO>x7Z5T$pR2mNx`Pz7k zzJ(CAJ`9zgA_|T(i^j;vrZPq-Hx=_x-U2uK1&sgBHc$VOWr2%8Wl_9*=m<@rXVANz zztEFZ*mm|pn8tO$NV9{LgC*l;XnaIzj3UY-3fUX?J&p{-UV$Mc#!CX0l-SEtiAy|A zzKqjjVnS776S#L&Oo^BW9mM4Hs1h57ZycN`p3ICN*&pk>ET%5U&Pc;C1-znnf=`U| zqayH2O-bo}hE|n*hQ36hZ(<6!z{=Cywzkq|?6v`@lpgr}8-05Xt$J%q-u8mGz2xmK zc)N?CQmw;* zW3UtmL*-&(&Ut{7>CgqRCEaGZLYYIcL{ zhvYUW$RR1@*sh_6cI2<0yD%TS87ulid1q)Hy3r#-5g~M;`k=C{MQtJ8d9Z}DV86P7 z_{A$K=HtAoVre)7p1FDZco(pr?%Dp#HZveHE5tXhp$ERYk}p*7g-X7I1>eEE^C0ek zfyBm5vC#1rIh#*GpdWG$Y*(#$*TMA1$_NSbt%Ad!=m?nyV-W~Y1x9|Ka{zW0v4bM#(qSKib0pxg)q7dmh6y|p(tz39p} zA1DS6&JL~m1M{Ano`vXwv=GhvyI1R)X3yNKZd_nWO?wJWdscd%Td5vg4Yrnodkew6 zrQo4L@X*H>i^0KC-C*7`xaLGVc9xoZ3(dWy=Kex+f3f+QQs9}{p?kjCx&B{IFP#3T zuj_%aNXg$(@OR{f7Q>4@`Of|o|I@3DEo9|c}Qps{7nvsRA+KcT(_w)KanBizqn2z`q=i|c+ey8XinK9HU5BB*+(yCo5q~2muKU~HEq`-?Pdq6mPQ!_U*VqJV z9N-Fv!GBi|7kb2pohD7?U$wl#^0-b|X$#7+ z>dGv$R`CPyIGY|)X(Oc0Fsaa!^V#5Yo49N(^_G6cm~vC--DU8g2>e1FNF@o1UOEx> z%&@B8Y-ic)Ho-Q-US%h#Npyw2h$bmL=+k^J9B38EwMZcuC?{Tl1O~ztNry%u0Znmy z67p7+q(w$Z8^P(MK5RtmzAB5szyy!^B$v|Z26UQKCOItP%4A5+An`SFF|y_W7S#++ z8N>$vP2;>ovb(E#g3$M9x;(&1BO7+YP4Wt7F|%jSG-Jm7+5L)fR7GiYXRh| zTWxClQ(f-DpJN}!itPsqO$TOAulkx6j=ysiVCiP*SAv*6j8V^=)8)^@@c*J@GgY3kbt zErZ|Pt84oPQLtD;=VC|R-}|368e0EV&Vo$Wk2@nB)Zg5PBW|=rQxONV#DqwF7Zq_a zOS>6T-_rs#%MJ?a%P#%vc11XPIpB!wpqF>Bq|VVmlOSQjEaV7u&w2=O*Cb068UD zhatgy3E(6JE}HNZz@;%~Wh&ey{xVz|L;zd@fRCf9HQ&I>B#*}dSOHJvbb6fJT+JJX z0n665%Ajm5G(gsrk{Q71&Dea2SGh?^mMs`8qbLRp2Ar~35@Z?xm>PJa49kzba=c;D zZUgXKH$1q&juUc5Ah&T6ZY&AI8)pCC@NaRon3C<2P@x}!)jL3>tVEi}M6!a7#gH5% zk-|94NlCqAJR?{v$wHNw#$_hRaS=()6M$!?^d!7YSTl_9@)hyVu)7jtG-gCf3Ai1) zv73DKNJH}2N|4cL;A%t~S2+!~c8bX*R`XizxFSu9nms)-qKK--0&npOylUz1Qw(|M z!Utf2LT)ic2E7;;(`qvi>4rVM`^UqOPI#WM`wl*O5PH~xnp+nx{=RM2yINB_YlrLl z10&Fs0$qhbS5Er4p%^#}xwJ2^K)o})+SGE}bIX%^H7Dkq_Rg{8sFZJiHrIdm;NsMs z=L#K1pp_3CB?0P{53+fG2e}T{%^jLQdh=+}$K@bv?!DKrd(l;FIFR=rShLgBeXFhQ zrPlq0*8Qc{!-dwv#nypRvAunIK<|4_GZ;dbm+tQhQB{COex>?eF7IQZ9^Vtr)x z)T+n7A!acvp02epiCHbE>Dg_=)iIF%`U&SrC$;2mjqFED-BhHHSqd|x-g}&af#p65 z8q51#Cs}&=h~p%pKSeCmKV@kch5NUjDL}fUF=x{$5$@xIz*IMja(#Md`N8rvct+gI zneUjdz4rQE4tidHJxob(afbIw!z5@arEXxt;C+PQaq_9Kwque*7}iG&Y4f;WbH?K- zJ}JiIT2(xrObZ#A)IIU|n;Bj%k2vCSA)SD3Up&6yxiucgBt~KKfMeuScd5*`}1I1 zZs?OEE5V^_&(B^gGDDxk1unBFt^^K2$AuzuXq~aKEs&Jhz2DeuY{xncwKY;J_fhPj zav#(l+UwZX^`0QR`{C1_>@H&`WD{q@bwm*(8AxqG5tyVEnlF)-Wq2ebZ_IuCZ~~KC z6(;$C=C+=e;Vp&a9lA<1yE;YQo-w(kXvnx1>)vlAmKseMk;LCfJ9Q1bK$@0TH0M#{ zK%T=d!2m%Pg=h|vD2lp|LSLfZFHrY=)bJ%bS48K&Ku5l|Bb$3xT%iIFZQ~TRE6+W( Qjz|S0x7B~G_v!rq2l+~=5dZ)H literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/streams/__pycache__/file.cpython-312.pyc b/.venv/Lib/site-packages/anyio/streams/__pycache__/file.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..40edf59ca0926ba08b08a0f29335e5db744d9e0f GIT binary patch literal 7546 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/streams/__pycache__/memory.cpython-312.pyc b/.venv/Lib/site-packages/anyio/streams/__pycache__/memory.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ea5a5b97f12d9214b11c0604ee0ef931bde62936 GIT binary patch literal 14962 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 Toa=w0K%j~-zRyFB9mKx@y27&d literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/streams/__pycache__/text.cpython-312.pyc b/.venv/Lib/site-packages/anyio/streams/__pycache__/text.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..161c0ffa32487d0c72ca50058dca9d442ca85222 GIT binary patch literal 8316 zcmeHMU2GKB6}~e&yE|TcXZ?>cU=Owdud&w{^Ak);V+e#a2_b=?Xfa)ncgA>Of1EpG z$huDC0&U$YZ4)UfeW)sk6cq}Uc+4x0RbN<^Xw9fmB1Nj2H`9%j$WJ}z-q~Mc0x7Cg zsaM)NXYM`s@0@$i`R453{C*#S5;*$V>3=j4@+H0$ikA~YUJ?koOmw0Pagq?if`GIb z7sDbvU2#`J3QGxh*v;CdxF_KadlPb4PSk{JSerZUOVoyIf%fR$cwNFD_9v9Ek_dzY ziTZGTq9NRnXbd+BL?ni+%QtIoz=~Kz@&eI)mxx|#)EiA}q2-2)b&wnULBh=s9a9Hm z{6@nnV_F_MMu9N_qj8lnt!Xh>{}rwp6zp0pnM_%l6-y<}BSF!Y4`}hYHW4>$?pCS%qKjoLN3W@*v5W}3EpGG@een87ugOn)WfY#zHA=>2KSc-@E^v2(^T ziyB(OZg5(U8A;t~@)w#oN7JhlXN;&-Ijo*HmW`@&TG*gNu(oKt6?MeN9*#(b{JZda znHVH2=p-z@0SXVhbkUG>*R#;0OJTR}hBps;^M*a_O~yA6s8_GK=_@EMEQ87i$boxJGZ%6?ppeW<3DUTBA;H(d#csMOFIK4Z&8s;kfa3<(afUf}ngV6fOt#JOv>e zRJEowOVy2NN;gb(0widvR!TK33JNgQ8517BW2mP=s!7#I0wXkqd~B}gaU62QOjS=M z4Tpb(DQaZ=U7R&)hF(lYsgW>}mKJ9t3_7l!pNd7NRBBi=G-;|@GR-E8rV`U}!!qJ& z=wh1G)tO`r=TW0m8r7nfL4n;=%~UFhPuN>pg<*yoOFFw6nFhv$YEdm|PN%39fz!Zk z7{OKe5eFtT)6fe`;Ax?sZNM2@IOj-d)#BMvJ~O7FPNpaq9138Cr3RPRpl5Jw>hY@x7{P7$}S4 zYU5n?Y9gi2#0}6+bcSgF?QJ~5=GIVd)6|$Uk|tZL|mNjjT3=YClW@tKXO{J2d6g@pSJQ$BnP>rSso$D}VCF0$T9!N3k<1(VPU<7u3 zwc3{5OlHePos|A!pejo z4L>3OBOopl%Wa;mF0d)jSKa!X^yJy>22(0?t*vqkrF*9Zv1Jhdc ztajRf`I6~aYLFX-IcR}90hQYRNMt%?S`n0QBr@B%!p(##7=o}*vjeJm^7pomT-%OJ z+m2grX502H`0uxEx_07T+l~e4*Zw?kkZ4ib@PeASh?@8ih?j@}+NdFOzQ=%dVfh-Q*ns=0M?9l`~G5E^jW=uQ(@C_#Gqf?cYt_>-mf8yl`DO z5|n5&46wb9qhh+VJzP^k7ge#-9i5sy3U#7M1+Rkk2(83G% z1Fef|I^I{7YDl1Iv3bw38Gwl{bdJixRbkX4eY6Rvhl_jx7`e#*bAbz}w8s>9L1_X> z6A*JJikWVP%@hRff%u<-%Z@f;yQyIs)^&l2*~Gi!2(=%`*|wEJ<%4%XuQ?1=L8dvS zJEL^xl)jA8msR?6a{nE?g+%EY;GSmgje z04s?4I7-wVgoJpD1D)@{g${}WlA>u2$P;cqvg&J?F4>89=+D%!>>xP#UqA`BI>Yx0J5Bw=mBU5 zid2OM+q;QN7b0;t(6j3+Eu#|3yapU5_oNKU1T$^HYrWaFVFWPD@GH)OG4Em}fPqL@ z4sn11%N#HrU1q6=oh>ssf=fr}SsD?jIWOZX?1yD+H2?(wz8SeSlP*uJ-is3d0^uLi{H2 zkjz5NiYUyWMoX0dIL>$zMSyp3b)0cm?qANMWnJj#1w^q~y6WkDx_E+agV|T?8p9(; z?j^q*ss;`xapZQa7)XFy!t8wqwlFBb!oNfhV?$*tMf0Vo{-8ofklu?GhAR34toC75 z{I=l{o!vpSLW;MFi~EO2;cn@3Sm8!^Jl~HLRybWTp4UP=ZzpSdv(lEbc;46!@%%tm zYQI0U>yv}`hW2AT4`rqOkdbrm$a_Th_Pi{(2bMgm#dBOJ3cq4;aZ1Sl8HlH!>RFKn zs(~z=q$@1ex3aX4PhW#cpKz_-h7mqor?1r;;pvBG6Fe0opttMIWwF0L-4a}9``BG& z$qwzWVErsEjj9tdJqF(#_|dP$3!(nec_GNXIA1A{RMB~4hRl(J9@xBqAUIY4Ui1o1 za^@gnTeXC3)$_42ZKbX-Nm(d>>3Q$i4(wlBbBY2Jys2 zjKGEVe}wWxsUts_;_3(mLnsF)>@xtqFPwYiWCoctfsYZqrcP5uV#p2S!Rm$l+sxui ziJ^zbZiwla408NLIXe2iV`N}!X5UK3q7(E!NfN>NaNTHeNgY$%(IBqUu|a?#b)F_K*!*tNS)U z->33g4u;C14hrHTitlwGo>r(nhDidclq3)-69W4nto~fa#@WV_^9woZ|0%Sa8=>M+ zx@B#yC75Xm=30g_EkoIs;ap(&jy!xPFuZK?K)nS5^(N`6dy7zk_KF9@Z_6h=U@6h` zD7;ocBdA{%BMVp-BX9+l#Q-`RC_60P>PyI_LRG>eof)Mwr}Si$o-4<*N?%UyyDRrO z2ki_(nrMskktbM*NQwvjZ-6daX7*^LCRbn>l(Pdp`4uj3{sPbWFx=IjQTnq=C?|*R z%AsZY67W^zZi*-S1N1zp3Ja;Ll?q%1w&QA5W%W52B;5kH-CMftE@tQ)C$W29edQT8 zWq$)XM$U2RuV7UZfmQWA*ql)|XO-TZ+YewFRd9dKO zi}KcGW;GW&M(Z#aCQDa00(DyyMt#z4mj`K|0Ck0g0dH_8`ePt2lh_mF$39*yZ;NwQ zm5&7{n+9Hx8OsnbaNkfZBkY-7S7s^IDEK$PU?RGmCrgs6-pAy^?Pgm>*|y|@wlDB2 zhRbR=qYN*(p>2t{YJ40y(_vhGH&(A;RRYHij}4BQg4tQRaSG<*(8?*A!FOQgSCIv) zarl`js4({x0Ib|a*7QK0s|+iba$mvFt%LW1BlEA`Y1y2WM(%g_UNi1>@0fr2eSpq8 z@{-5x%hxmfEV#GkJ%W1>k#xV46qBHrC&hr`xE*%@$tTGDP0qkSevk*GXaoE+JrGUB z;~amQA#EZ`G3rqax^`{xZ(qoQda&7x6=nf#kCn!MiD?bKxNux8_MxYy3=b$s1+c2e zihZVFc8*6%+!B2bs~)Vnpt9v>d1`VW#Y>7Y%={3lC6^!wpOLOFiT`sl@HrXEkfF~= z>o<~D5WgW%J!mFk?SgSnX#QHk*s_Gp501mX^98m}U~AcQ nC7NmJ%M*BU*noQQd>Pwz!T0|9-$yeIU3mgD<9Z+h#diH~gvze? literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/streams/__pycache__/tls.cpython-312.pyc b/.venv/Lib/site-packages/anyio/streams/__pycache__/tls.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d41a95a03866d70d6988ac4e35f2aa71d6bd0bdf GIT binary patch literal 17581 zcmd6PYj70TnP~S+&-*FOXe5LlEhL0SNCQF`gLqkhcw10NwqqIYFif{##60Bgma!D! zP}tevP410Ias%1T){=_1f)}Tj)ZMBix9+Wk#ICsZ{!ud|J?`5C&`WZW!b|e@v@heI@Mi)O0r>6UoatbuZlW$zKT)3vO@uPxiEyT2qJh-8(veK#L}R9D zqKW)=r&nZ}Cz>-WCst-!CR#GB6RkAG+orY|LnysD&)MS?CAfexFZ9?x(Vk%^SenW@ zNl8bk#6s}_&UXXGjL*a>_}$L=&EK7T7yMbxub#B5fO;;Vy(hY%wA=i(#zO6*xZoQU zSI0Nruo6_%L=WI{bM^0p3~U4{3{VaHN(1VK224#vYeGi=x{+_;quBehHodc!XwyfC zAxf*BL^hj~5>hIc6-T2M)ww&7PA5*KdDZc3VtP82Jq4Yf458F8*F)ae9 zbvQe#I>u+G`R5bDM;63qQ$xFi+*v+*j2Ck=LXsa5gq)yyMzY+I$uUXb6B)G*Fy%x( zKAD61$(eL|R&6}ZOYvkPo8;4Jo{RIZCgY?x)g|TP(iv#RL4S4F6*nwNLh96v#Ew9mB|ggws%tzUp4}(pW~QT-k8tKc@*w#Z)vFI@ zd}bP^!2VozI*~l9I>+P3cCC#z|pH4_T$C_&?#vZvvNnq#M(Oi~SeTnpRHa;!nq+BwWR&A$X zjYYLNc?LExpN^kOWjWZaaVagvXR@i6XZX3Wgp2qR;OJvXlFCXaRC_WteTEn2dJ!ui z=Tb?@gn{4jqr1nCjgOC)vM1EwG|vn1Briy*$y5@^ob!_I4cZ#3>yeyxsEh!!k221cEUjC7tbUF*wz}Q;v=6ZrekAchmV|^;**lt>B6KNlQoz`G3mvm50ba3B}l19ncYLj zpMyydk0(-`kP?p{orQH1GDn3Rjz~N{E%cwpgPD+W!tr$Ow0Qg!q;X(C@yyKGE$ffR zUg5K^96y{obzDqId_SJb#AzPzWoJ{lbueDwEaEyCa%_55XvO|9L0ZM{K=Nhk17_y~ zJJqp1&kkI8c3~*b4BYQ|I^VNpk!ibT%QIWDWM%kg@Z zz$f|CE5JIiD&{8G#?PcgmfRuinS{t@bL{lYsdOsIrm`t1l}M-Ncws9$Bl7G}hL_F^ zoy1;GLM>bn2`;8l1YPp4N&<9e+%FAd5g3FnkTM(cUT7)=>XVWYP6o}q-uJTui;Dlu~Nj(O+2W#0OZ z^@hFz=Uv%831vg_Of?(1(i<>EO23Spfr+DU=p%m}B%CjT^z&`Y73-haY}9#|g_@`4 z>3Q3{3!&d(ZrHTe=iT$}DP+o3&%A4@t*Quq8e^`;PgC>mG3sgRYn$Mo^M}@Rbkvr( z0|b!6hJ54&ILN>s;N-$R3lf3JR#MWL$4VdiVa4`@a{&JV@iYT$hlL{!EF{apoqQHf zDPqCniZ^~)tD)(H0KBXEqz(ZBA}REnHDx48IdbYv(sd+d(!vmX^5nQM!=D7!Gzt9z zQ-igB$L6x> zS;U zWFnOowW|-Q8&#W*9E~5?H+tmQNc_3ckuMw_**!k8Cq8myZ`7h)UjhBF7)uKPk3_WZ~(?MFnL{ z#;vG2V85X(pgMA7Dnwx?AXZ(a>y|-cDqyMk1oP z>d>Vr5${2qQ~eP(Vq*qt=lrHL7Q^31phjE=H|YPSKD|H{hbV93qNlCU)_t|_(xLl- z=KE_meam{qbJ?Q=*W3=S`ER>_cIc;vlx<`3wy~m>@`WGTsg-R?^G3OO> zf|6k4x5UMkO?LuM7lJF5VCU^%=Q~!VXOG;oXK~FQIk@N7!Oq{+g|D<;ZvAHaCHvj_ zhAaJ-`@gyFlH;M1@&*??c~8q*)*tx4=a)UP!ip|sMZdhFzYvUEbzFbx{T}GJIkrSu zn*DDcga&L>X&;c=2S{ICaoC8C9@H28HH{CZexO(`!<78%+s(aFsj;fiHErAF=mL& zOa+$n3}C4t4^ElVT?ti5&I5zvG|Z(b<8^_8Na(4BsfN5~&_h!%QrSaNlhFs@dFH(B zF%&%!5416ml)Y=onx(!aQ>vV|T?8ZWdE0BYbM!gtRqKn?Ir>G|3)vlI`=zA}v7QBb zcRqF<{`L1XuAH^B{xEm{r;NTDGV1>i^I1kATXP04{X4FBr$NEIt&FZNqqOuk^e?e_ z-Zq7|TGb=;aG*ids(FPHnqfDh+FSJqj>;WZIzJqB(Q*;ER^<*{uzc-riT+?2Ra+{B zi}(xs4;&te9~&9ob6|8|w1J2ZaMSX{#7OR9l>uV}r!uHq3&TK)8iYIlg+x|51|^!+ z+o2mKhzNpab5Ono)HPL?rik;oN!4*=j6e$>tf`39w(Qc7Yc`#8w$Jny6MVxr?aM zY2pEq4uogn_Z&)SnyDsMTVDA#K#6W(-I};yrvjm(rN`Iy!HU+a($$p<_Tqk;3O8NZ zd3mQ2>b)K6Ei{94uug7Xr^^WAKaT$>t~_->e(FH}sYChZ!%Fz@V)*dA#?}R2(MB~q zOMmw80HA18LTlvEnkCBbTUWIB>ek(BTzTb7m%pSm#%?#p3T>;Dwn4dVP-)vNw{8AO z_-E}uZCAEDD{px=zvW22?WodpRBk$YuVb~+u}SXOq;%|%J9gwdo>5jlv$*n^g+0X} z)v)5q=;cu*+#`p3u7`gej(z$tKs9xKOwo1g3NQpx*(ZnleiM$}ZEX9PverFaQGO>J z!{0|PA5p^na=8Cac-`IR{+ok~;Z46UIsp2g9(u_@dgM?Kp!FS~3z23evR00)RU+%< z$oiY%AGiOgT^SgW2S)M(`|^?fN^pNZxc_b_qJ+BTP&ahy8w3&NivO}-3HHdro;$%_ z{2jO)P=Zl87`+o*dp8ojE-nT){2rQJ*>-u`$CSqh0?_9)3bkHMzBTxRo!{GeCp1_H zH(ojXjl+wpcmG`c)%>k_dG#2~x6-)ocH_FcZ38#O#ipU(wMDN>i%o;~f(^efHbNJV z9t^U1iy_e84cY)Gsf#y2 zIYogzK{Ix>K&fu*qNd6r2pEMzLJgs%mJn7ZK2;b@$OWexQ*@-{HT48hjI=RDtx~Jc zZBxV01tX}{`xC^RNedD8{)5Im=iV?iy*;`vNR&E5votlCa$||WOEW?ijU&Vlg35T0 zrl@elT%y}-`ZU`Ko8~7aFwGJz6&WsjYG!hh7ougFV$@04m4GUrYM;p>HcjOe^GM`eHXdY95WB=-&}y~A?v zaNfU5aqe1l?kYIFU-!T1SDdWuWbZgv;qSnk0ma!NJ3H<;I}6Z0&?N`Du5mxeelM$Z zZ;`vVn2DUCbw-z0gYd7c-DCS*^?()(%=v{8+o#A%KR%}m@RJ85+2r}mOgnacQ ztRS*BZs)4Ukkd?Qo=85r+*`w@I)&F$)w2wTZUdyLS+vlt0T~u4B@f6-EKNzK)CSwG zMlWTDg!&@1EtkhGQikjZxCe3by-kls?V6^KYoz*iB}9JYRozS>_@GR?tL>V{S;#<1 z`J%rJzsnb016xEW1SN}J@B|c3=WS1C(ZT=^jWl05d-?1)GoZpQ20M#xvLiZWf2ZQ_ zmHoYWf1l#)lbwA<4^`Lo+1(KPF=g>Z?nc&JXOy1pa?kdBWQP*mAqRI9f(=C*)IBOX zDOdj^aX0jM(Ko!6UI-2QsPEIm9_B3ua@Sj-?3Rrl-oo6n+c58;q4<`sV|bJGR*W7V zu-{te!2Bi#YAcjWbECWl$jy!NNAaR0Krpj<#40 zE0l)yasynW%D}KZFsuyhl?V2|@5(nEQv$~>F&_j%ck5dhy{-2Gp-Y~kiwcgxfkU=< zv3EQD4!xE6VPN}X<`DPTzx5pIN5@v0F>Be39R~`)@P)ifWk5j8hm)mks zK)nxTA_~je^!V$m+1E32?=wH|%KP^z&V9F?`;58R2y?N4`JsJdCF8-heI1PzJ+OzK zG#8S2D?aHiJWrPxLM?UxN`SfBz{zA0o-Mg^<}Firz^fi`?dZGPczBE~|4G7%$S~j&zRBHNeJwrRO-e zHrlgu=y;6eqB}oAS_Qnw1)MKf+H;sk$IIMST)sGH2t82-R4_b!h~c@50Qb*RI)b2f9I6E?Vfuu0q$kYuk%fx?#hT)!JBJ1nIv1Au#w= z1@Fj`)e>+QDT~Yf8Bvoi?h5XzuRI$KKr3)8dTAT1H$Bk&JF>sWpwY`7EM6*K)fA#zA&PxBo$rI zoC3~m=|tufm)J4aS2~u2E0p5w#MriU4oni_4#;TGe}KM4v?6|bfx5X-8Qd)o?p6km z$b&}~k3M&2@OcvH@^3V-ap867xOybQm!a@qHi&=1L9EaQ@sloP=%74wP#Jn&9(o?M z=Z99yR{!#0;0%-XSr3^ftWS+&KSpU{k+v+vqxG*a2nr|?F@g(L;yS0qcF3_EO6=h6 z*umw*BTzt^E^G^6eEh=d z;{m0z7l-o4kAi`Ymr&orlf)^TMsIH#{bQ+%(%NkQ@zmLHj&PvOqX{+c69Ho+#3^9hZh1&2i7Zq@Bor8|24z8=j}JE_GfrX-iLBz#;~h(j za8lDA{v&ig*Zg>PwgmNJUYqhFQy+8}P*m3Rx{b1bW6=s_zw|GD8%RxW5Nqs96Zii=de%dIVrS2KU$9ZdMloCiZw^@vl=sf>3Q@hs0Z=)QU*q(KY8 z)%N#lfI{mrT5yD?;Rop8lkl4BHX_GgdPxhLe#wZHK5?RtH6o}_2&WM^SPddvhGGG) zVi1EdKetkgk*$cG(=9?L;37j9mBAq1C=Kc&jmo8nIKGGp!Nx)kN@uVD^IGXQA*Z*W zYu97kUxHrx*wO%iU?@3pA{r3-v0)68b(kQN7X~0vJtPQFbJ`2zSo|y|s3r<8V}dHH zfLfVw0TR^-aWN2AB+UxA8-)#+3}S+=crueDLD#aJfg}`-I3oHX|4b?V+7_>JY_}46(NTLY~v@_^P z59rd3rw6n^FQBU|s7Fd=03Sqru%OK8!8RmTN;iaQ!C-orE1F{=@Y}S?#)+EatVZnm$?Aw(9itw1Wh{p|w_5a7X%)&M>Yfm)Wd@dMkvC*026(Li zs{}ilPMl_^;R6_)p);TXpN25NoDn=+x>#@roGiyznrU1oSS6qsGB5xLwj=uYvM?yp z9JgAJ(IIq%t~;2&1jf6^Fit9-m;`s?Ni8&O&S%UFaK>QIh zebqLZ&Lt$ZZW*x^)2J!Zw(k%lkI2|_|ybq<4N$mNfI|k=VAzIL!+t9CUmPzT<$P!RpQ-O40216jNPGAezv3z00 z+bVlozk4R{U88shWG{rr_1zRPW^cno@KX2z2pfHO_D&%B&csiwcean`w?BWU|Am6L z4xnORpo=RhSC8(X3JhPHw5m`^R$5=^vaJb$%IqTHMwwT@Oe(a@F+q96_O3ut#1jX;iu zZ&u;^)$=rlsbLV_o33PcLm?q)5Ll1j z(ZU~tbJ0NEo6MI?3$zJe>4a5F_qG2M}c(NC;YWHUsdHnv^O<|F+| zuwM@L7we$zQ&P3q@bsf%JyjR`?4g4ScVNiKP7*OPAV&sncHVqNb0_{Lxa0R=x%Tb+ zgNVw`>yBN0^jGVLw^Dzxez@Oy%SR8dwcqkHn6Gz2@vUYLK-^kQoQmBx%&(=fw%<0q z$#H9g17Wt%SiaS@D{B1()3B?{`im9xt`_?*nr)bG$5y}SvSDr13VBep$iff}lc-;) zXn}7JeZInXAW>~(dI1nuM)+$ia!c?bZk)Ij1U&sBat^pvSWPQ>2YwN+pUDjgie0!6 z==J+d<9=?+9k_Jvt8M>i@wsB4Yq*;rK*$vX{UZ?idgjfH;_s0C9oN>~9LoE5D9#fO7CR;s~s{G`~lD5>&PEawbQr*IISUH{Y)Wb)nhQS$DGPC|DJ_R zjixYW0LwD}H2Ox&(Q6*+7jgJ40Ic~&{Po%xSIPcWd4HGU?7Hpj(mi=?J@hrYoB5u- zXZh%WZh9#OXwX|BnIovhc!{MO?DQ$LPg^SO(?E=7LPUx_*Gwk-DL|F%Guo-tOntHP zkyaa#N{7-gILD!5;j4%ZwP@fct(fnvK!38#{L}Iz^mqw~E1~VD7pO{GOVMgULkhTl zw0`V_%V-Sg``B6KhSvSVf_c zVP&DNJ!P=VF~t7#p8oMs(BdZKIbJLSn4Ff+k-$^xD-;V&_n z#bg)~_?lx@R0HraI9d}yixy*vQ%M0Ch=78;>M{S<0$vpGx>sGOMM+@y5(!sQ?eMh* z2yz1Y)&vZ=60T$7!31w-P4YuVp?$m&gfBq^J{HH1JOH^Q2S|;S+BC+jMQK zlY5dZ;08pBr+{pC)wxakzI%u8Gbn?FrNj>*fg6IRe@m_U2g?8Vli;d( z@mp%;hgAC~jGeapBL&GPeu~~je@H!(r=GcIwJX+;Yz-}(yKQazkXgIPto>iiru&|H z_=?)ocES09r}3&g@9DhYEVu&;wuR)?!G$xI1J^=}!7kao`huh22`)5V?ObS)5&WTj z1sz=sbv>lu{a`a?@m%8X(BX%c16JC-;9jEe4Li!xP$WeUzF;rGJVyge&($q*{puwO Ne-OY27R-_f_`mp;u`2)o literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/anyio/streams/buffered.py b/.venv/Lib/site-packages/anyio/streams/buffered.py new file mode 100644 index 0000000..f5d5e83 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/streams/buffered.py @@ -0,0 +1,119 @@ +from __future__ import annotations + +from collections.abc import Callable, Mapping +from dataclasses import dataclass, field +from typing import Any + +from .. import ClosedResourceError, DelimiterNotFound, EndOfStream, IncompleteRead +from ..abc import AnyByteReceiveStream, ByteReceiveStream + + +@dataclass(eq=False) +class BufferedByteReceiveStream(ByteReceiveStream): + """ + Wraps any bytes-based receive stream and uses a buffer to provide sophisticated + receiving capabilities in the form of a byte stream. + """ + + receive_stream: AnyByteReceiveStream + _buffer: bytearray = field(init=False, default_factory=bytearray) + _closed: bool = field(init=False, default=False) + + async def aclose(self) -> None: + await self.receive_stream.aclose() + self._closed = True + + @property + def buffer(self) -> bytes: + """The bytes currently in the buffer.""" + return bytes(self._buffer) + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return self.receive_stream.extra_attributes + + async def receive(self, max_bytes: int = 65536) -> bytes: + if self._closed: + raise ClosedResourceError + + if self._buffer: + chunk = bytes(self._buffer[:max_bytes]) + del self._buffer[:max_bytes] + return chunk + elif isinstance(self.receive_stream, ByteReceiveStream): + return await self.receive_stream.receive(max_bytes) + else: + # With a bytes-oriented object stream, we need to handle any surplus bytes + # we get from the receive() call + chunk = await self.receive_stream.receive() + if len(chunk) > max_bytes: + # Save the surplus bytes in the buffer + self._buffer.extend(chunk[max_bytes:]) + return chunk[:max_bytes] + else: + return chunk + + async def receive_exactly(self, nbytes: int) -> bytes: + """ + Read exactly the given amount of bytes from the stream. + + :param nbytes: the number of bytes to read + :return: the bytes read + :raises ~anyio.IncompleteRead: if the stream was closed before the requested + amount of bytes could be read from the stream + + """ + while True: + remaining = nbytes - len(self._buffer) + if remaining <= 0: + retval = self._buffer[:nbytes] + del self._buffer[:nbytes] + return bytes(retval) + + try: + if isinstance(self.receive_stream, ByteReceiveStream): + chunk = await self.receive_stream.receive(remaining) + else: + chunk = await self.receive_stream.receive() + except EndOfStream as exc: + raise IncompleteRead from exc + + self._buffer.extend(chunk) + + async def receive_until(self, delimiter: bytes, max_bytes: int) -> bytes: + """ + Read from the stream until the delimiter is found or max_bytes have been read. + + :param delimiter: the marker to look for in the stream + :param max_bytes: maximum number of bytes that will be read before raising + :exc:`~anyio.DelimiterNotFound` + :return: the bytes read (not including the delimiter) + :raises ~anyio.IncompleteRead: if the stream was closed before the delimiter + was found + :raises ~anyio.DelimiterNotFound: if the delimiter is not found within the + bytes read up to the maximum allowed + + """ + delimiter_size = len(delimiter) + offset = 0 + while True: + # Check if the delimiter can be found in the current buffer + index = self._buffer.find(delimiter, offset) + if index >= 0: + found = self._buffer[:index] + del self._buffer[: index + len(delimiter) :] + return bytes(found) + + # Check if the buffer is already at or over the limit + if len(self._buffer) >= max_bytes: + raise DelimiterNotFound(max_bytes) + + # Read more data into the buffer from the socket + try: + data = await self.receive_stream.receive() + except EndOfStream as exc: + raise IncompleteRead from exc + + # Move the offset forward and add the new data to the buffer + offset = max(len(self._buffer) - delimiter_size + 1, 0) + self._buffer.extend(data) diff --git a/.venv/Lib/site-packages/anyio/streams/file.py b/.venv/Lib/site-packages/anyio/streams/file.py new file mode 100644 index 0000000..f492464 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/streams/file.py @@ -0,0 +1,148 @@ +from __future__ import annotations + +from collections.abc import Callable, Mapping +from io import SEEK_SET, UnsupportedOperation +from os import PathLike +from pathlib import Path +from typing import Any, BinaryIO, cast + +from .. import ( + BrokenResourceError, + ClosedResourceError, + EndOfStream, + TypedAttributeSet, + to_thread, + typed_attribute, +) +from ..abc import ByteReceiveStream, ByteSendStream + + +class FileStreamAttribute(TypedAttributeSet): + #: the open file descriptor + file: BinaryIO = typed_attribute() + #: the path of the file on the file system, if available (file must be a real file) + path: Path = typed_attribute() + #: the file number, if available (file must be a real file or a TTY) + fileno: int = typed_attribute() + + +class _BaseFileStream: + def __init__(self, file: BinaryIO): + self._file = file + + async def aclose(self) -> None: + await to_thread.run_sync(self._file.close) + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + attributes: dict[Any, Callable[[], Any]] = { + FileStreamAttribute.file: lambda: self._file, + } + + if hasattr(self._file, "name"): + attributes[FileStreamAttribute.path] = lambda: Path(self._file.name) + + try: + self._file.fileno() + except UnsupportedOperation: + pass + else: + attributes[FileStreamAttribute.fileno] = lambda: self._file.fileno() + + return attributes + + +class FileReadStream(_BaseFileStream, ByteReceiveStream): + """ + A byte stream that reads from a file in the file system. + + :param file: a file that has been opened for reading in binary mode + + .. versionadded:: 3.0 + """ + + @classmethod + async def from_path(cls, path: str | PathLike[str]) -> FileReadStream: + """ + Create a file read stream by opening the given file. + + :param path: path of the file to read from + + """ + file = await to_thread.run_sync(Path(path).open, "rb") + return cls(cast(BinaryIO, file)) + + async def receive(self, max_bytes: int = 65536) -> bytes: + try: + data = await to_thread.run_sync(self._file.read, max_bytes) + except ValueError: + raise ClosedResourceError from None + except OSError as exc: + raise BrokenResourceError from exc + + if data: + return data + else: + raise EndOfStream + + async def seek(self, position: int, whence: int = SEEK_SET) -> int: + """ + Seek the file to the given position. + + .. seealso:: :meth:`io.IOBase.seek` + + .. note:: Not all file descriptors are seekable. + + :param position: position to seek the file to + :param whence: controls how ``position`` is interpreted + :return: the new absolute position + :raises OSError: if the file is not seekable + + """ + return await to_thread.run_sync(self._file.seek, position, whence) + + async def tell(self) -> int: + """ + Return the current stream position. + + .. note:: Not all file descriptors are seekable. + + :return: the current absolute position + :raises OSError: if the file is not seekable + + """ + return await to_thread.run_sync(self._file.tell) + + +class FileWriteStream(_BaseFileStream, ByteSendStream): + """ + A byte stream that writes to a file in the file system. + + :param file: a file that has been opened for writing in binary mode + + .. versionadded:: 3.0 + """ + + @classmethod + async def from_path( + cls, path: str | PathLike[str], append: bool = False + ) -> FileWriteStream: + """ + Create a file write stream by opening the given file for writing. + + :param path: path of the file to write to + :param append: if ``True``, open the file for appending; if ``False``, any + existing file at the given path will be truncated + + """ + mode = "ab" if append else "wb" + file = await to_thread.run_sync(Path(path).open, mode) + return cls(cast(BinaryIO, file)) + + async def send(self, item: bytes) -> None: + try: + await to_thread.run_sync(self._file.write, item) + except ValueError: + raise ClosedResourceError from None + except OSError as exc: + raise BrokenResourceError from exc diff --git a/.venv/Lib/site-packages/anyio/streams/memory.py b/.venv/Lib/site-packages/anyio/streams/memory.py new file mode 100644 index 0000000..83bf1d9 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/streams/memory.py @@ -0,0 +1,317 @@ +from __future__ import annotations + +import warnings +from collections import OrderedDict, deque +from dataclasses import dataclass, field +from types import TracebackType +from typing import Generic, NamedTuple, TypeVar + +from .. import ( + BrokenResourceError, + ClosedResourceError, + EndOfStream, + WouldBlock, +) +from .._core._testing import TaskInfo, get_current_task +from ..abc import Event, ObjectReceiveStream, ObjectSendStream +from ..lowlevel import checkpoint + +T_Item = TypeVar("T_Item") +T_co = TypeVar("T_co", covariant=True) +T_contra = TypeVar("T_contra", contravariant=True) + + +class MemoryObjectStreamStatistics(NamedTuple): + current_buffer_used: int #: number of items stored in the buffer + #: maximum number of items that can be stored on this stream (or :data:`math.inf`) + max_buffer_size: float + open_send_streams: int #: number of unclosed clones of the send stream + open_receive_streams: int #: number of unclosed clones of the receive stream + #: number of tasks blocked on :meth:`MemoryObjectSendStream.send` + tasks_waiting_send: int + #: number of tasks blocked on :meth:`MemoryObjectReceiveStream.receive` + tasks_waiting_receive: int + + +@dataclass(eq=False) +class MemoryObjectItemReceiver(Generic[T_Item]): + task_info: TaskInfo = field(init=False, default_factory=get_current_task) + item: T_Item = field(init=False) + + def __repr__(self) -> str: + # When item is not defined, we get following error with default __repr__: + # AttributeError: 'MemoryObjectItemReceiver' object has no attribute 'item' + item = getattr(self, "item", None) + return f"{self.__class__.__name__}(task_info={self.task_info}, item={item!r})" + + +@dataclass(eq=False) +class MemoryObjectStreamState(Generic[T_Item]): + max_buffer_size: float = field() + buffer: deque[T_Item] = field(init=False, default_factory=deque) + open_send_channels: int = field(init=False, default=0) + open_receive_channels: int = field(init=False, default=0) + waiting_receivers: OrderedDict[Event, MemoryObjectItemReceiver[T_Item]] = field( + init=False, default_factory=OrderedDict + ) + waiting_senders: OrderedDict[Event, T_Item] = field( + init=False, default_factory=OrderedDict + ) + + def statistics(self) -> MemoryObjectStreamStatistics: + return MemoryObjectStreamStatistics( + len(self.buffer), + self.max_buffer_size, + self.open_send_channels, + self.open_receive_channels, + len(self.waiting_senders), + len(self.waiting_receivers), + ) + + +@dataclass(eq=False) +class MemoryObjectReceiveStream(Generic[T_co], ObjectReceiveStream[T_co]): + _state: MemoryObjectStreamState[T_co] + _closed: bool = field(init=False, default=False) + + def __post_init__(self) -> None: + self._state.open_receive_channels += 1 + + def receive_nowait(self) -> T_co: + """ + Receive the next item if it can be done without waiting. + + :return: the received item + :raises ~anyio.ClosedResourceError: if this send stream has been closed + :raises ~anyio.EndOfStream: if the buffer is empty and this stream has been + closed from the sending end + :raises ~anyio.WouldBlock: if there are no items in the buffer and no tasks + waiting to send + + """ + if self._closed: + raise ClosedResourceError + + if self._state.waiting_senders: + # Get the item from the next sender + send_event, item = self._state.waiting_senders.popitem(last=False) + self._state.buffer.append(item) + send_event.set() + + if self._state.buffer: + return self._state.buffer.popleft() + elif not self._state.open_send_channels: + raise EndOfStream + + raise WouldBlock + + async def receive(self) -> T_co: + await checkpoint() + try: + return self.receive_nowait() + except WouldBlock: + # Add ourselves in the queue + receive_event = Event() + receiver = MemoryObjectItemReceiver[T_co]() + self._state.waiting_receivers[receive_event] = receiver + + try: + await receive_event.wait() + finally: + self._state.waiting_receivers.pop(receive_event, None) + + try: + return receiver.item + except AttributeError: + raise EndOfStream from None + + def clone(self) -> MemoryObjectReceiveStream[T_co]: + """ + Create a clone of this receive stream. + + Each clone can be closed separately. Only when all clones have been closed will + the receiving end of the memory stream be considered closed by the sending ends. + + :return: the cloned stream + + """ + if self._closed: + raise ClosedResourceError + + return MemoryObjectReceiveStream(_state=self._state) + + def close(self) -> None: + """ + Close the stream. + + This works the exact same way as :meth:`aclose`, but is provided as a special + case for the benefit of synchronous callbacks. + + """ + if not self._closed: + self._closed = True + self._state.open_receive_channels -= 1 + if self._state.open_receive_channels == 0: + send_events = list(self._state.waiting_senders.keys()) + for event in send_events: + event.set() + + async def aclose(self) -> None: + self.close() + + def statistics(self) -> MemoryObjectStreamStatistics: + """ + Return statistics about the current state of this stream. + + .. versionadded:: 3.0 + """ + return self._state.statistics() + + def __enter__(self) -> MemoryObjectReceiveStream[T_co]: + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self.close() + + def __del__(self) -> None: + if not self._closed: + warnings.warn( + f"Unclosed <{self.__class__.__name__} at {id(self):x}>", + ResourceWarning, + source=self, + ) + + +@dataclass(eq=False) +class MemoryObjectSendStream(Generic[T_contra], ObjectSendStream[T_contra]): + _state: MemoryObjectStreamState[T_contra] + _closed: bool = field(init=False, default=False) + + def __post_init__(self) -> None: + self._state.open_send_channels += 1 + + def send_nowait(self, item: T_contra) -> None: + """ + Send an item immediately if it can be done without waiting. + + :param item: the item to send + :raises ~anyio.ClosedResourceError: if this send stream has been closed + :raises ~anyio.BrokenResourceError: if the stream has been closed from the + receiving end + :raises ~anyio.WouldBlock: if the buffer is full and there are no tasks waiting + to receive + + """ + if self._closed: + raise ClosedResourceError + if not self._state.open_receive_channels: + raise BrokenResourceError + + while self._state.waiting_receivers: + receive_event, receiver = self._state.waiting_receivers.popitem(last=False) + if not receiver.task_info.has_pending_cancellation(): + receiver.item = item + receive_event.set() + return + + if len(self._state.buffer) < self._state.max_buffer_size: + self._state.buffer.append(item) + else: + raise WouldBlock + + async def send(self, item: T_contra) -> None: + """ + Send an item to the stream. + + If the buffer is full, this method blocks until there is again room in the + buffer or the item can be sent directly to a receiver. + + :param item: the item to send + :raises ~anyio.ClosedResourceError: if this send stream has been closed + :raises ~anyio.BrokenResourceError: if the stream has been closed from the + receiving end + + """ + await checkpoint() + try: + self.send_nowait(item) + except WouldBlock: + # Wait until there's someone on the receiving end + send_event = Event() + self._state.waiting_senders[send_event] = item + try: + await send_event.wait() + except BaseException: + self._state.waiting_senders.pop(send_event, None) + raise + + if send_event in self._state.waiting_senders: + del self._state.waiting_senders[send_event] + raise BrokenResourceError from None + + def clone(self) -> MemoryObjectSendStream[T_contra]: + """ + Create a clone of this send stream. + + Each clone can be closed separately. Only when all clones have been closed will + the sending end of the memory stream be considered closed by the receiving ends. + + :return: the cloned stream + + """ + if self._closed: + raise ClosedResourceError + + return MemoryObjectSendStream(_state=self._state) + + def close(self) -> None: + """ + Close the stream. + + This works the exact same way as :meth:`aclose`, but is provided as a special + case for the benefit of synchronous callbacks. + + """ + if not self._closed: + self._closed = True + self._state.open_send_channels -= 1 + if self._state.open_send_channels == 0: + receive_events = list(self._state.waiting_receivers.keys()) + self._state.waiting_receivers.clear() + for event in receive_events: + event.set() + + async def aclose(self) -> None: + self.close() + + def statistics(self) -> MemoryObjectStreamStatistics: + """ + Return statistics about the current state of this stream. + + .. versionadded:: 3.0 + """ + return self._state.statistics() + + def __enter__(self) -> MemoryObjectSendStream[T_contra]: + return self + + def __exit__( + self, + exc_type: type[BaseException] | None, + exc_val: BaseException | None, + exc_tb: TracebackType | None, + ) -> None: + self.close() + + def __del__(self) -> None: + if not self._closed: + warnings.warn( + f"Unclosed <{self.__class__.__name__} at {id(self):x}>", + ResourceWarning, + source=self, + ) diff --git a/.venv/Lib/site-packages/anyio/streams/stapled.py b/.venv/Lib/site-packages/anyio/streams/stapled.py new file mode 100644 index 0000000..80f64a2 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/streams/stapled.py @@ -0,0 +1,141 @@ +from __future__ import annotations + +from collections.abc import Callable, Mapping, Sequence +from dataclasses import dataclass +from typing import Any, Generic, TypeVar + +from ..abc import ( + ByteReceiveStream, + ByteSendStream, + ByteStream, + Listener, + ObjectReceiveStream, + ObjectSendStream, + ObjectStream, + TaskGroup, +) + +T_Item = TypeVar("T_Item") +T_Stream = TypeVar("T_Stream") + + +@dataclass(eq=False) +class StapledByteStream(ByteStream): + """ + Combines two byte streams into a single, bidirectional byte stream. + + Extra attributes will be provided from both streams, with the receive stream + providing the values in case of a conflict. + + :param ByteSendStream send_stream: the sending byte stream + :param ByteReceiveStream receive_stream: the receiving byte stream + """ + + send_stream: ByteSendStream + receive_stream: ByteReceiveStream + + async def receive(self, max_bytes: int = 65536) -> bytes: + return await self.receive_stream.receive(max_bytes) + + async def send(self, item: bytes) -> None: + await self.send_stream.send(item) + + async def send_eof(self) -> None: + await self.send_stream.aclose() + + async def aclose(self) -> None: + await self.send_stream.aclose() + await self.receive_stream.aclose() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return { + **self.send_stream.extra_attributes, + **self.receive_stream.extra_attributes, + } + + +@dataclass(eq=False) +class StapledObjectStream(Generic[T_Item], ObjectStream[T_Item]): + """ + Combines two object streams into a single, bidirectional object stream. + + Extra attributes will be provided from both streams, with the receive stream + providing the values in case of a conflict. + + :param ObjectSendStream send_stream: the sending object stream + :param ObjectReceiveStream receive_stream: the receiving object stream + """ + + send_stream: ObjectSendStream[T_Item] + receive_stream: ObjectReceiveStream[T_Item] + + async def receive(self) -> T_Item: + return await self.receive_stream.receive() + + async def send(self, item: T_Item) -> None: + await self.send_stream.send(item) + + async def send_eof(self) -> None: + await self.send_stream.aclose() + + async def aclose(self) -> None: + await self.send_stream.aclose() + await self.receive_stream.aclose() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return { + **self.send_stream.extra_attributes, + **self.receive_stream.extra_attributes, + } + + +@dataclass(eq=False) +class MultiListener(Generic[T_Stream], Listener[T_Stream]): + """ + Combines multiple listeners into one, serving connections from all of them at once. + + Any MultiListeners in the given collection of listeners will have their listeners + moved into this one. + + Extra attributes are provided from each listener, with each successive listener + overriding any conflicting attributes from the previous one. + + :param listeners: listeners to serve + :type listeners: Sequence[Listener[T_Stream]] + """ + + listeners: Sequence[Listener[T_Stream]] + + def __post_init__(self) -> None: + listeners: list[Listener[T_Stream]] = [] + for listener in self.listeners: + if isinstance(listener, MultiListener): + listeners.extend(listener.listeners) + del listener.listeners[:] # type: ignore[attr-defined] + else: + listeners.append(listener) + + self.listeners = listeners + + async def serve( + self, handler: Callable[[T_Stream], Any], task_group: TaskGroup | None = None + ) -> None: + from .. import create_task_group + + async with create_task_group() as tg: + for listener in self.listeners: + tg.start_soon(listener.serve, handler, task_group) + + async def aclose(self) -> None: + for listener in self.listeners: + await listener.aclose() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + attributes: dict = {} + for listener in self.listeners: + attributes.update(listener.extra_attributes) + + return attributes diff --git a/.venv/Lib/site-packages/anyio/streams/text.py b/.venv/Lib/site-packages/anyio/streams/text.py new file mode 100644 index 0000000..f1a1127 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/streams/text.py @@ -0,0 +1,147 @@ +from __future__ import annotations + +import codecs +from collections.abc import Callable, Mapping +from dataclasses import InitVar, dataclass, field +from typing import Any + +from ..abc import ( + AnyByteReceiveStream, + AnyByteSendStream, + AnyByteStream, + ObjectReceiveStream, + ObjectSendStream, + ObjectStream, +) + + +@dataclass(eq=False) +class TextReceiveStream(ObjectReceiveStream[str]): + """ + Stream wrapper that decodes bytes to strings using the given encoding. + + Decoding is done using :class:`~codecs.IncrementalDecoder` which returns any + completely received unicode characters as soon as they come in. + + :param transport_stream: any bytes-based receive stream + :param encoding: character encoding to use for decoding bytes to strings (defaults + to ``utf-8``) + :param errors: handling scheme for decoding errors (defaults to ``strict``; see the + `codecs module documentation`_ for a comprehensive list of options) + + .. _codecs module documentation: + https://docs.python.org/3/library/codecs.html#codec-objects + """ + + transport_stream: AnyByteReceiveStream + encoding: InitVar[str] = "utf-8" + errors: InitVar[str] = "strict" + _decoder: codecs.IncrementalDecoder = field(init=False) + + def __post_init__(self, encoding: str, errors: str) -> None: + decoder_class = codecs.getincrementaldecoder(encoding) + self._decoder = decoder_class(errors=errors) + + async def receive(self) -> str: + while True: + chunk = await self.transport_stream.receive() + decoded = self._decoder.decode(chunk) + if decoded: + return decoded + + async def aclose(self) -> None: + await self.transport_stream.aclose() + self._decoder.reset() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return self.transport_stream.extra_attributes + + +@dataclass(eq=False) +class TextSendStream(ObjectSendStream[str]): + """ + Sends strings to the wrapped stream as bytes using the given encoding. + + :param AnyByteSendStream transport_stream: any bytes-based send stream + :param str encoding: character encoding to use for encoding strings to bytes + (defaults to ``utf-8``) + :param str errors: handling scheme for encoding errors (defaults to ``strict``; see + the `codecs module documentation`_ for a comprehensive list of options) + + .. _codecs module documentation: + https://docs.python.org/3/library/codecs.html#codec-objects + """ + + transport_stream: AnyByteSendStream + encoding: InitVar[str] = "utf-8" + errors: str = "strict" + _encoder: Callable[..., tuple[bytes, int]] = field(init=False) + + def __post_init__(self, encoding: str) -> None: + self._encoder = codecs.getencoder(encoding) + + async def send(self, item: str) -> None: + encoded = self._encoder(item, self.errors)[0] + await self.transport_stream.send(encoded) + + async def aclose(self) -> None: + await self.transport_stream.aclose() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return self.transport_stream.extra_attributes + + +@dataclass(eq=False) +class TextStream(ObjectStream[str]): + """ + A bidirectional stream that decodes bytes to strings on receive and encodes strings + to bytes on send. + + Extra attributes will be provided from both streams, with the receive stream + providing the values in case of a conflict. + + :param AnyByteStream transport_stream: any bytes-based stream + :param str encoding: character encoding to use for encoding/decoding strings to/from + bytes (defaults to ``utf-8``) + :param str errors: handling scheme for encoding errors (defaults to ``strict``; see + the `codecs module documentation`_ for a comprehensive list of options) + + .. _codecs module documentation: + https://docs.python.org/3/library/codecs.html#codec-objects + """ + + transport_stream: AnyByteStream + encoding: InitVar[str] = "utf-8" + errors: InitVar[str] = "strict" + _receive_stream: TextReceiveStream = field(init=False) + _send_stream: TextSendStream = field(init=False) + + def __post_init__(self, encoding: str, errors: str) -> None: + self._receive_stream = TextReceiveStream( + self.transport_stream, encoding=encoding, errors=errors + ) + self._send_stream = TextSendStream( + self.transport_stream, encoding=encoding, errors=errors + ) + + async def receive(self) -> str: + return await self._receive_stream.receive() + + async def send(self, item: str) -> None: + await self._send_stream.send(item) + + async def send_eof(self) -> None: + await self.transport_stream.send_eof() + + async def aclose(self) -> None: + await self._send_stream.aclose() + await self._receive_stream.aclose() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return { + **self._send_stream.extra_attributes, + **self._receive_stream.extra_attributes, + } diff --git a/.venv/Lib/site-packages/anyio/streams/tls.py b/.venv/Lib/site-packages/anyio/streams/tls.py new file mode 100644 index 0000000..70a41cc --- /dev/null +++ b/.venv/Lib/site-packages/anyio/streams/tls.py @@ -0,0 +1,352 @@ +from __future__ import annotations + +import logging +import re +import ssl +import sys +from collections.abc import Callable, Mapping +from dataclasses import dataclass +from functools import wraps +from typing import Any, TypeVar + +from .. import ( + BrokenResourceError, + EndOfStream, + aclose_forcefully, + get_cancelled_exc_class, + to_thread, +) +from .._core._typedattr import TypedAttributeSet, typed_attribute +from ..abc import AnyByteStream, ByteStream, Listener, TaskGroup + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +T_Retval = TypeVar("T_Retval") +PosArgsT = TypeVarTuple("PosArgsT") +_PCTRTT = tuple[tuple[str, str], ...] +_PCTRTTT = tuple[_PCTRTT, ...] + + +class TLSAttribute(TypedAttributeSet): + """Contains Transport Layer Security related attributes.""" + + #: the selected ALPN protocol + alpn_protocol: str | None = typed_attribute() + #: the channel binding for type ``tls-unique`` + channel_binding_tls_unique: bytes = typed_attribute() + #: the selected cipher + cipher: tuple[str, str, int] = typed_attribute() + #: the peer certificate in dictionary form (see :meth:`ssl.SSLSocket.getpeercert` + # for more information) + peer_certificate: None | (dict[str, str | _PCTRTTT | _PCTRTT]) = typed_attribute() + #: the peer certificate in binary form + peer_certificate_binary: bytes | None = typed_attribute() + #: ``True`` if this is the server side of the connection + server_side: bool = typed_attribute() + #: ciphers shared by the client during the TLS handshake (``None`` if this is the + #: client side) + shared_ciphers: list[tuple[str, str, int]] | None = typed_attribute() + #: the :class:`~ssl.SSLObject` used for encryption + ssl_object: ssl.SSLObject = typed_attribute() + #: ``True`` if this stream does (and expects) a closing TLS handshake when the + #: stream is being closed + standard_compatible: bool = typed_attribute() + #: the TLS protocol version (e.g. ``TLSv1.2``) + tls_version: str = typed_attribute() + + +@dataclass(eq=False) +class TLSStream(ByteStream): + """ + A stream wrapper that encrypts all sent data and decrypts received data. + + This class has no public initializer; use :meth:`wrap` instead. + All extra attributes from :class:`~TLSAttribute` are supported. + + :var AnyByteStream transport_stream: the wrapped stream + + """ + + transport_stream: AnyByteStream + standard_compatible: bool + _ssl_object: ssl.SSLObject + _read_bio: ssl.MemoryBIO + _write_bio: ssl.MemoryBIO + + @classmethod + async def wrap( + cls, + transport_stream: AnyByteStream, + *, + server_side: bool | None = None, + hostname: str | None = None, + ssl_context: ssl.SSLContext | None = None, + standard_compatible: bool = True, + ) -> TLSStream: + """ + Wrap an existing stream with Transport Layer Security. + + This performs a TLS handshake with the peer. + + :param transport_stream: a bytes-transporting stream to wrap + :param server_side: ``True`` if this is the server side of the connection, + ``False`` if this is the client side (if omitted, will be set to ``False`` + if ``hostname`` has been provided, ``False`` otherwise). Used only to create + a default context when an explicit context has not been provided. + :param hostname: host name of the peer (if host name checking is desired) + :param ssl_context: the SSLContext object to use (if not provided, a secure + default will be created) + :param standard_compatible: if ``False``, skip the closing handshake when + closing the connection, and don't raise an exception if the peer does the + same + :raises ~ssl.SSLError: if the TLS handshake fails + + """ + if server_side is None: + server_side = not hostname + + if not ssl_context: + purpose = ( + ssl.Purpose.CLIENT_AUTH if server_side else ssl.Purpose.SERVER_AUTH + ) + ssl_context = ssl.create_default_context(purpose) + + # Re-enable detection of unexpected EOFs if it was disabled by Python + if hasattr(ssl, "OP_IGNORE_UNEXPECTED_EOF"): + ssl_context.options &= ~ssl.OP_IGNORE_UNEXPECTED_EOF + + bio_in = ssl.MemoryBIO() + bio_out = ssl.MemoryBIO() + + # External SSLContext implementations may do blocking I/O in wrap_bio(), + # but the standard library implementation won't + if type(ssl_context) is ssl.SSLContext: + ssl_object = ssl_context.wrap_bio( + bio_in, bio_out, server_side=server_side, server_hostname=hostname + ) + else: + ssl_object = await to_thread.run_sync( + ssl_context.wrap_bio, + bio_in, + bio_out, + server_side, + hostname, + None, + ) + + wrapper = cls( + transport_stream=transport_stream, + standard_compatible=standard_compatible, + _ssl_object=ssl_object, + _read_bio=bio_in, + _write_bio=bio_out, + ) + await wrapper._call_sslobject_method(ssl_object.do_handshake) + return wrapper + + async def _call_sslobject_method( + self, func: Callable[[Unpack[PosArgsT]], T_Retval], *args: Unpack[PosArgsT] + ) -> T_Retval: + while True: + try: + result = func(*args) + except ssl.SSLWantReadError: + try: + # Flush any pending writes first + if self._write_bio.pending: + await self.transport_stream.send(self._write_bio.read()) + + data = await self.transport_stream.receive() + except EndOfStream: + self._read_bio.write_eof() + except OSError as exc: + self._read_bio.write_eof() + self._write_bio.write_eof() + raise BrokenResourceError from exc + else: + self._read_bio.write(data) + except ssl.SSLWantWriteError: + await self.transport_stream.send(self._write_bio.read()) + except ssl.SSLSyscallError as exc: + self._read_bio.write_eof() + self._write_bio.write_eof() + raise BrokenResourceError from exc + except ssl.SSLError as exc: + self._read_bio.write_eof() + self._write_bio.write_eof() + if isinstance(exc, ssl.SSLEOFError) or ( + exc.strerror and "UNEXPECTED_EOF_WHILE_READING" in exc.strerror + ): + if self.standard_compatible: + raise BrokenResourceError from exc + else: + raise EndOfStream from None + + raise + else: + # Flush any pending writes first + if self._write_bio.pending: + await self.transport_stream.send(self._write_bio.read()) + + return result + + async def unwrap(self) -> tuple[AnyByteStream, bytes]: + """ + Does the TLS closing handshake. + + :return: a tuple of (wrapped byte stream, bytes left in the read buffer) + + """ + await self._call_sslobject_method(self._ssl_object.unwrap) + self._read_bio.write_eof() + self._write_bio.write_eof() + return self.transport_stream, self._read_bio.read() + + async def aclose(self) -> None: + if self.standard_compatible: + try: + await self.unwrap() + except BaseException: + await aclose_forcefully(self.transport_stream) + raise + + await self.transport_stream.aclose() + + async def receive(self, max_bytes: int = 65536) -> bytes: + data = await self._call_sslobject_method(self._ssl_object.read, max_bytes) + if not data: + raise EndOfStream + + return data + + async def send(self, item: bytes) -> None: + await self._call_sslobject_method(self._ssl_object.write, item) + + async def send_eof(self) -> None: + tls_version = self.extra(TLSAttribute.tls_version) + match = re.match(r"TLSv(\d+)(?:\.(\d+))?", tls_version) + if match: + major, minor = int(match.group(1)), int(match.group(2) or 0) + if (major, minor) < (1, 3): + raise NotImplementedError( + f"send_eof() requires at least TLSv1.3; current " + f"session uses {tls_version}" + ) + + raise NotImplementedError( + "send_eof() has not yet been implemented for TLS streams" + ) + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return { + **self.transport_stream.extra_attributes, + TLSAttribute.alpn_protocol: self._ssl_object.selected_alpn_protocol, + TLSAttribute.channel_binding_tls_unique: ( + self._ssl_object.get_channel_binding + ), + TLSAttribute.cipher: self._ssl_object.cipher, + TLSAttribute.peer_certificate: lambda: self._ssl_object.getpeercert(False), + TLSAttribute.peer_certificate_binary: lambda: self._ssl_object.getpeercert( + True + ), + TLSAttribute.server_side: lambda: self._ssl_object.server_side, + TLSAttribute.shared_ciphers: lambda: self._ssl_object.shared_ciphers() + if self._ssl_object.server_side + else None, + TLSAttribute.standard_compatible: lambda: self.standard_compatible, + TLSAttribute.ssl_object: lambda: self._ssl_object, + TLSAttribute.tls_version: self._ssl_object.version, + } + + +@dataclass(eq=False) +class TLSListener(Listener[TLSStream]): + """ + A convenience listener that wraps another listener and auto-negotiates a TLS session + on every accepted connection. + + If the TLS handshake times out or raises an exception, + :meth:`handle_handshake_error` is called to do whatever post-mortem processing is + deemed necessary. + + Supports only the :attr:`~TLSAttribute.standard_compatible` extra attribute. + + :param Listener listener: the listener to wrap + :param ssl_context: the SSL context object + :param standard_compatible: a flag passed through to :meth:`TLSStream.wrap` + :param handshake_timeout: time limit for the TLS handshake + (passed to :func:`~anyio.fail_after`) + """ + + listener: Listener[Any] + ssl_context: ssl.SSLContext + standard_compatible: bool = True + handshake_timeout: float = 30 + + @staticmethod + async def handle_handshake_error(exc: BaseException, stream: AnyByteStream) -> None: + """ + Handle an exception raised during the TLS handshake. + + This method does 3 things: + + #. Forcefully closes the original stream + #. Logs the exception (unless it was a cancellation exception) using the + ``anyio.streams.tls`` logger + #. Reraises the exception if it was a base exception or a cancellation exception + + :param exc: the exception + :param stream: the original stream + + """ + await aclose_forcefully(stream) + + # Log all except cancellation exceptions + if not isinstance(exc, get_cancelled_exc_class()): + # CPython (as of 3.11.5) returns incorrect `sys.exc_info()` here when using + # any asyncio implementation, so we explicitly pass the exception to log + # (https://github.com/python/cpython/issues/108668). Trio does not have this + # issue because it works around the CPython bug. + logging.getLogger(__name__).exception( + "Error during TLS handshake", exc_info=exc + ) + + # Only reraise base exceptions and cancellation exceptions + if not isinstance(exc, Exception) or isinstance(exc, get_cancelled_exc_class()): + raise + + async def serve( + self, + handler: Callable[[TLSStream], Any], + task_group: TaskGroup | None = None, + ) -> None: + @wraps(handler) + async def handler_wrapper(stream: AnyByteStream) -> None: + from .. import fail_after + + try: + with fail_after(self.handshake_timeout): + wrapped_stream = await TLSStream.wrap( + stream, + ssl_context=self.ssl_context, + standard_compatible=self.standard_compatible, + ) + except BaseException as exc: + await self.handle_handshake_error(exc, stream) + else: + await handler(wrapped_stream) + + await self.listener.serve(handler_wrapper, task_group) + + async def aclose(self) -> None: + await self.listener.aclose() + + @property + def extra_attributes(self) -> Mapping[Any, Callable[[], Any]]: + return { + TLSAttribute.standard_compatible: lambda: self.standard_compatible, + } diff --git a/.venv/Lib/site-packages/anyio/to_interpreter.py b/.venv/Lib/site-packages/anyio/to_interpreter.py new file mode 100644 index 0000000..8a2e993 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/to_interpreter.py @@ -0,0 +1,218 @@ +from __future__ import annotations + +import atexit +import os +import pickle +import sys +from collections import deque +from collections.abc import Callable +from textwrap import dedent +from typing import Any, Final, TypeVar + +from . import current_time, to_thread +from ._core._exceptions import BrokenWorkerIntepreter +from ._core._synchronization import CapacityLimiter +from .lowlevel import RunVar + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +UNBOUND: Final = 2 # I have no clue how this works, but it was used in the stdlib +FMT_UNPICKLED: Final = 0 +FMT_PICKLED: Final = 1 +DEFAULT_CPU_COUNT: Final = 8 # this is just an arbitrarily selected value +MAX_WORKER_IDLE_TIME = ( + 30 # seconds a subinterpreter can be idle before becoming eligible for pruning +) + +T_Retval = TypeVar("T_Retval") +PosArgsT = TypeVarTuple("PosArgsT") + +_idle_workers = RunVar[deque["Worker"]]("_available_workers") +_default_interpreter_limiter = RunVar[CapacityLimiter]("_default_interpreter_limiter") + + +class Worker: + _run_func = compile( + dedent(""" + import _interpqueues as queues + import _interpreters as interpreters + from pickle import loads, dumps, HIGHEST_PROTOCOL + + item = queues.get(queue_id)[0] + try: + func, args = loads(item) + retval = func(*args) + except BaseException as exc: + is_exception = True + retval = exc + else: + is_exception = False + + try: + queues.put(queue_id, (retval, is_exception), FMT_UNPICKLED, UNBOUND) + except interpreters.NotShareableError: + retval = dumps(retval, HIGHEST_PROTOCOL) + queues.put(queue_id, (retval, is_exception), FMT_PICKLED, UNBOUND) + """), + "", + "exec", + ) + + last_used: float = 0 + + _initialized: bool = False + _interpreter_id: int + _queue_id: int + + def initialize(self) -> None: + import _interpqueues as queues + import _interpreters as interpreters + + self._interpreter_id = interpreters.create() + self._queue_id = queues.create(2, FMT_UNPICKLED, UNBOUND) + self._initialized = True + interpreters.set___main___attrs( + self._interpreter_id, + { + "queue_id": self._queue_id, + "FMT_PICKLED": FMT_PICKLED, + "FMT_UNPICKLED": FMT_UNPICKLED, + "UNBOUND": UNBOUND, + }, + ) + + def destroy(self) -> None: + import _interpqueues as queues + import _interpreters as interpreters + + if self._initialized: + interpreters.destroy(self._interpreter_id) + queues.destroy(self._queue_id) + + def _call( + self, + func: Callable[..., T_Retval], + args: tuple[Any], + ) -> tuple[Any, bool]: + import _interpqueues as queues + import _interpreters as interpreters + + if not self._initialized: + self.initialize() + + payload = pickle.dumps((func, args), pickle.HIGHEST_PROTOCOL) + queues.put(self._queue_id, payload, FMT_PICKLED, UNBOUND) + + res: Any + is_exception: bool + if exc_info := interpreters.exec(self._interpreter_id, self._run_func): + raise BrokenWorkerIntepreter(exc_info) + + (res, is_exception), fmt = queues.get(self._queue_id)[:2] + if fmt == FMT_PICKLED: + res = pickle.loads(res) + + return res, is_exception + + async def call( + self, + func: Callable[..., T_Retval], + args: tuple[Any], + limiter: CapacityLimiter, + ) -> T_Retval: + result, is_exception = await to_thread.run_sync( + self._call, + func, + args, + limiter=limiter, + ) + if is_exception: + raise result + + return result + + +def _stop_workers(workers: deque[Worker]) -> None: + for worker in workers: + worker.destroy() + + workers.clear() + + +async def run_sync( + func: Callable[[Unpack[PosArgsT]], T_Retval], + *args: Unpack[PosArgsT], + limiter: CapacityLimiter | None = None, +) -> T_Retval: + """ + Call the given function with the given arguments in a subinterpreter. + + If the ``cancellable`` option is enabled and the task waiting for its completion is + cancelled, the call will still run its course but its return value (or any raised + exception) will be ignored. + + .. warning:: This feature is **experimental**. The upstream interpreter API has not + yet been finalized or thoroughly tested, so don't rely on this for anything + mission critical. + + :param func: a callable + :param args: positional arguments for the callable + :param limiter: capacity limiter to use to limit the total amount of subinterpreters + running (if omitted, the default limiter is used) + :return: the result of the call + :raises BrokenWorkerIntepreter: if there's an internal error in a subinterpreter + + """ + if sys.version_info <= (3, 13): + raise RuntimeError("subinterpreters require at least Python 3.13") + + if limiter is None: + limiter = current_default_interpreter_limiter() + + try: + idle_workers = _idle_workers.get() + except LookupError: + idle_workers = deque() + _idle_workers.set(idle_workers) + atexit.register(_stop_workers, idle_workers) + + async with limiter: + try: + worker = idle_workers.pop() + except IndexError: + worker = Worker() + + try: + return await worker.call(func, args, limiter) + finally: + # Prune workers that have been idle for too long + now = current_time() + while idle_workers: + if now - idle_workers[0].last_used <= MAX_WORKER_IDLE_TIME: + break + + await to_thread.run_sync(idle_workers.popleft().destroy, limiter=limiter) + + worker.last_used = current_time() + idle_workers.append(worker) + + +def current_default_interpreter_limiter() -> CapacityLimiter: + """ + Return the capacity limiter that is used by default to limit the number of + concurrently running subinterpreters. + + Defaults to the number of CPU cores. + + :return: a capacity limiter object + + """ + try: + return _default_interpreter_limiter.get() + except LookupError: + limiter = CapacityLimiter(os.cpu_count() or DEFAULT_CPU_COUNT) + _default_interpreter_limiter.set(limiter) + return limiter diff --git a/.venv/Lib/site-packages/anyio/to_process.py b/.venv/Lib/site-packages/anyio/to_process.py new file mode 100644 index 0000000..495de2a --- /dev/null +++ b/.venv/Lib/site-packages/anyio/to_process.py @@ -0,0 +1,258 @@ +from __future__ import annotations + +import os +import pickle +import subprocess +import sys +from collections import deque +from collections.abc import Callable +from importlib.util import module_from_spec, spec_from_file_location +from typing import TypeVar, cast + +from ._core._eventloop import current_time, get_async_backend, get_cancelled_exc_class +from ._core._exceptions import BrokenWorkerProcess +from ._core._subprocesses import open_process +from ._core._synchronization import CapacityLimiter +from ._core._tasks import CancelScope, fail_after +from .abc import ByteReceiveStream, ByteSendStream, Process +from .lowlevel import RunVar, checkpoint_if_cancelled +from .streams.buffered import BufferedByteReceiveStream + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +WORKER_MAX_IDLE_TIME = 300 # 5 minutes + +T_Retval = TypeVar("T_Retval") +PosArgsT = TypeVarTuple("PosArgsT") + +_process_pool_workers: RunVar[set[Process]] = RunVar("_process_pool_workers") +_process_pool_idle_workers: RunVar[deque[tuple[Process, float]]] = RunVar( + "_process_pool_idle_workers" +) +_default_process_limiter: RunVar[CapacityLimiter] = RunVar("_default_process_limiter") + + +async def run_sync( # type: ignore[return] + func: Callable[[Unpack[PosArgsT]], T_Retval], + *args: Unpack[PosArgsT], + cancellable: bool = False, + limiter: CapacityLimiter | None = None, +) -> T_Retval: + """ + Call the given function with the given arguments in a worker process. + + If the ``cancellable`` option is enabled and the task waiting for its completion is + cancelled, the worker process running it will be abruptly terminated using SIGKILL + (or ``terminateProcess()`` on Windows). + + :param func: a callable + :param args: positional arguments for the callable + :param cancellable: ``True`` to allow cancellation of the operation while it's + running + :param limiter: capacity limiter to use to limit the total amount of processes + running (if omitted, the default limiter is used) + :return: an awaitable that yields the return value of the function. + + """ + + async def send_raw_command(pickled_cmd: bytes) -> object: + try: + await stdin.send(pickled_cmd) + response = await buffered.receive_until(b"\n", 50) + status, length = response.split(b" ") + if status not in (b"RETURN", b"EXCEPTION"): + raise RuntimeError( + f"Worker process returned unexpected response: {response!r}" + ) + + pickled_response = await buffered.receive_exactly(int(length)) + except BaseException as exc: + workers.discard(process) + try: + process.kill() + with CancelScope(shield=True): + await process.aclose() + except ProcessLookupError: + pass + + if isinstance(exc, get_cancelled_exc_class()): + raise + else: + raise BrokenWorkerProcess from exc + + retval = pickle.loads(pickled_response) + if status == b"EXCEPTION": + assert isinstance(retval, BaseException) + raise retval + else: + return retval + + # First pickle the request before trying to reserve a worker process + await checkpoint_if_cancelled() + request = pickle.dumps(("run", func, args), protocol=pickle.HIGHEST_PROTOCOL) + + # If this is the first run in this event loop thread, set up the necessary variables + try: + workers = _process_pool_workers.get() + idle_workers = _process_pool_idle_workers.get() + except LookupError: + workers = set() + idle_workers = deque() + _process_pool_workers.set(workers) + _process_pool_idle_workers.set(idle_workers) + get_async_backend().setup_process_pool_exit_at_shutdown(workers) + + async with limiter or current_default_process_limiter(): + # Pop processes from the pool (starting from the most recently used) until we + # find one that hasn't exited yet + process: Process + while idle_workers: + process, idle_since = idle_workers.pop() + if process.returncode is None: + stdin = cast(ByteSendStream, process.stdin) + buffered = BufferedByteReceiveStream( + cast(ByteReceiveStream, process.stdout) + ) + + # Prune any other workers that have been idle for WORKER_MAX_IDLE_TIME + # seconds or longer + now = current_time() + killed_processes: list[Process] = [] + while idle_workers: + if now - idle_workers[0][1] < WORKER_MAX_IDLE_TIME: + break + + process_to_kill, idle_since = idle_workers.popleft() + process_to_kill.kill() + workers.remove(process_to_kill) + killed_processes.append(process_to_kill) + + with CancelScope(shield=True): + for killed_process in killed_processes: + await killed_process.aclose() + + break + + workers.remove(process) + else: + command = [sys.executable, "-u", "-m", __name__] + process = await open_process( + command, stdin=subprocess.PIPE, stdout=subprocess.PIPE + ) + try: + stdin = cast(ByteSendStream, process.stdin) + buffered = BufferedByteReceiveStream( + cast(ByteReceiveStream, process.stdout) + ) + with fail_after(20): + message = await buffered.receive(6) + + if message != b"READY\n": + raise BrokenWorkerProcess( + f"Worker process returned unexpected response: {message!r}" + ) + + main_module_path = getattr(sys.modules["__main__"], "__file__", None) + pickled = pickle.dumps( + ("init", sys.path, main_module_path), + protocol=pickle.HIGHEST_PROTOCOL, + ) + await send_raw_command(pickled) + except (BrokenWorkerProcess, get_cancelled_exc_class()): + raise + except BaseException as exc: + process.kill() + raise BrokenWorkerProcess( + "Error during worker process initialization" + ) from exc + + workers.add(process) + + with CancelScope(shield=not cancellable): + try: + return cast(T_Retval, await send_raw_command(request)) + finally: + if process in workers: + idle_workers.append((process, current_time())) + + +def current_default_process_limiter() -> CapacityLimiter: + """ + Return the capacity limiter that is used by default to limit the number of worker + processes. + + :return: a capacity limiter object + + """ + try: + return _default_process_limiter.get() + except LookupError: + limiter = CapacityLimiter(os.cpu_count() or 2) + _default_process_limiter.set(limiter) + return limiter + + +def process_worker() -> None: + # Redirect standard streams to os.devnull so that user code won't interfere with the + # parent-worker communication + stdin = sys.stdin + stdout = sys.stdout + sys.stdin = open(os.devnull) + sys.stdout = open(os.devnull, "w") + + stdout.buffer.write(b"READY\n") + while True: + retval = exception = None + try: + command, *args = pickle.load(stdin.buffer) + except EOFError: + return + except BaseException as exc: + exception = exc + else: + if command == "run": + func, args = args + try: + retval = func(*args) + except BaseException as exc: + exception = exc + elif command == "init": + main_module_path: str | None + sys.path, main_module_path = args + del sys.modules["__main__"] + if main_module_path and os.path.isfile(main_module_path): + # Load the parent's main module but as __mp_main__ instead of + # __main__ (like multiprocessing does) to avoid infinite recursion + try: + spec = spec_from_file_location("__mp_main__", main_module_path) + if spec and spec.loader: + main = module_from_spec(spec) + spec.loader.exec_module(main) + sys.modules["__main__"] = main + except BaseException as exc: + exception = exc + try: + if exception is not None: + status = b"EXCEPTION" + pickled = pickle.dumps(exception, pickle.HIGHEST_PROTOCOL) + else: + status = b"RETURN" + pickled = pickle.dumps(retval, pickle.HIGHEST_PROTOCOL) + except BaseException as exc: + exception = exc + status = b"EXCEPTION" + pickled = pickle.dumps(exc, pickle.HIGHEST_PROTOCOL) + + stdout.buffer.write(b"%s %d\n" % (status, len(pickled))) + stdout.buffer.write(pickled) + + # Respect SIGTERM + if isinstance(exception, SystemExit): + raise exception + + +if __name__ == "__main__": + process_worker() diff --git a/.venv/Lib/site-packages/anyio/to_thread.py b/.venv/Lib/site-packages/anyio/to_thread.py new file mode 100644 index 0000000..5070516 --- /dev/null +++ b/.venv/Lib/site-packages/anyio/to_thread.py @@ -0,0 +1,69 @@ +from __future__ import annotations + +import sys +from collections.abc import Callable +from typing import TypeVar +from warnings import warn + +from ._core._eventloop import get_async_backend +from .abc import CapacityLimiter + +if sys.version_info >= (3, 11): + from typing import TypeVarTuple, Unpack +else: + from typing_extensions import TypeVarTuple, Unpack + +T_Retval = TypeVar("T_Retval") +PosArgsT = TypeVarTuple("PosArgsT") + + +async def run_sync( + func: Callable[[Unpack[PosArgsT]], T_Retval], + *args: Unpack[PosArgsT], + abandon_on_cancel: bool = False, + cancellable: bool | None = None, + limiter: CapacityLimiter | None = None, +) -> T_Retval: + """ + Call the given function with the given arguments in a worker thread. + + If the ``cancellable`` option is enabled and the task waiting for its completion is + cancelled, the thread will still run its course but its return value (or any raised + exception) will be ignored. + + :param func: a callable + :param args: positional arguments for the callable + :param abandon_on_cancel: ``True`` to abandon the thread (leaving it to run + unchecked on own) if the host task is cancelled, ``False`` to ignore + cancellations in the host task until the operation has completed in the worker + thread + :param cancellable: deprecated alias of ``abandon_on_cancel``; will override + ``abandon_on_cancel`` if both parameters are passed + :param limiter: capacity limiter to use to limit the total amount of threads running + (if omitted, the default limiter is used) + :return: an awaitable that yields the return value of the function. + + """ + if cancellable is not None: + abandon_on_cancel = cancellable + warn( + "The `cancellable=` keyword argument to `anyio.to_thread.run_sync` is " + "deprecated since AnyIO 4.1.0; use `abandon_on_cancel=` instead", + DeprecationWarning, + stacklevel=2, + ) + + return await get_async_backend().run_sync_in_worker_thread( + func, args, abandon_on_cancel=abandon_on_cancel, limiter=limiter + ) + + +def current_default_thread_limiter() -> CapacityLimiter: + """ + Return the capacity limiter that is used by default to limit the number of + concurrent threads. + + :return: a capacity limiter object + + """ + return get_async_backend().current_default_thread_limiter() diff --git a/.venv/Lib/site-packages/click-8.1.8.dist-info/INSTALLER b/.venv/Lib/site-packages/click-8.1.8.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/click-8.1.8.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/click-8.1.8.dist-info/LICENSE.txt b/.venv/Lib/site-packages/click-8.1.8.dist-info/LICENSE.txt new file mode 100644 index 0000000..d12a849 --- /dev/null +++ b/.venv/Lib/site-packages/click-8.1.8.dist-info/LICENSE.txt @@ -0,0 +1,28 @@ +Copyright 2014 Pallets + +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/.venv/Lib/site-packages/click-8.1.8.dist-info/METADATA b/.venv/Lib/site-packages/click-8.1.8.dist-info/METADATA new file mode 100644 index 0000000..366d1a7 --- /dev/null +++ b/.venv/Lib/site-packages/click-8.1.8.dist-info/METADATA @@ -0,0 +1,74 @@ +Metadata-Version: 2.3 +Name: click +Version: 8.1.8 +Summary: Composable command line interface toolkit +Maintainer-email: Pallets +Requires-Python: >=3.7 +Description-Content-Type: text/markdown +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: Typing :: Typed +Requires-Dist: colorama; platform_system == 'Windows' +Requires-Dist: importlib-metadata; python_version < '3.8' +Project-URL: Changes, https://click.palletsprojects.com/changes/ +Project-URL: Chat, https://discord.gg/pallets +Project-URL: Documentation, https://click.palletsprojects.com/ +Project-URL: Donate, https://palletsprojects.com/donate +Project-URL: Source, https://github.com/pallets/click/ + +# $ click_ + +Click is a Python package for creating beautiful command line interfaces +in a composable way with as little code as necessary. It's the "Command +Line Interface Creation Kit". It's highly configurable but comes with +sensible defaults out of the box. + +It aims to make the process of writing command line tools quick and fun +while also preventing any frustration caused by the inability to +implement an intended CLI API. + +Click in three points: + +- Arbitrary nesting of commands +- Automatic help page generation +- Supports lazy loading of subcommands at runtime + + +## A Simple Example + +```python +import click + +@click.command() +@click.option("--count", default=1, help="Number of greetings.") +@click.option("--name", prompt="Your name", help="The person to greet.") +def hello(count, name): + """Simple program that greets NAME for a total of COUNT times.""" + for _ in range(count): + click.echo(f"Hello, {name}!") + +if __name__ == '__main__': + hello() +``` + +``` +$ python hello.py --count=3 +Your name: Click +Hello, Click! +Hello, Click! +Hello, Click! +``` + + +## Donate + +The Pallets organization develops and supports Click and other popular +packages. In order to grow the community of contributors and users, and +allow the maintainers to devote more time to the projects, [please +donate today][]. + +[please donate today]: https://palletsprojects.com/donate + diff --git a/.venv/Lib/site-packages/click-8.1.8.dist-info/RECORD b/.venv/Lib/site-packages/click-8.1.8.dist-info/RECORD new file mode 100644 index 0000000..bb8947c --- /dev/null +++ b/.venv/Lib/site-packages/click-8.1.8.dist-info/RECORD @@ -0,0 +1,38 @@ +click-8.1.8.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +click-8.1.8.dist-info/LICENSE.txt,sha256=morRBqOU6FO_4h9C9OctWSgZoigF2ZG18ydQKSkrZY0,1475 +click-8.1.8.dist-info/METADATA,sha256=WJtQ6uGS2ybLfvUE4vC0XIhIBr4yFGwjrMBR2fiCQ-Q,2263 +click-8.1.8.dist-info/RECORD,, +click-8.1.8.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82 +click/__init__.py,sha256=j1DJeCbga4ribkv5uyvIAzI0oFN13fW9mevDKShFelo,3188 +click/__pycache__/__init__.cpython-312.pyc,, +click/__pycache__/_compat.cpython-312.pyc,, +click/__pycache__/_termui_impl.cpython-312.pyc,, +click/__pycache__/_textwrap.cpython-312.pyc,, +click/__pycache__/_winconsole.cpython-312.pyc,, +click/__pycache__/core.cpython-312.pyc,, +click/__pycache__/decorators.cpython-312.pyc,, +click/__pycache__/exceptions.cpython-312.pyc,, +click/__pycache__/formatting.cpython-312.pyc,, +click/__pycache__/globals.cpython-312.pyc,, +click/__pycache__/parser.cpython-312.pyc,, +click/__pycache__/shell_completion.cpython-312.pyc,, +click/__pycache__/termui.cpython-312.pyc,, +click/__pycache__/testing.cpython-312.pyc,, +click/__pycache__/types.cpython-312.pyc,, +click/__pycache__/utils.cpython-312.pyc,, +click/_compat.py,sha256=IGKh_J5QdfKELitnRfTGHneejWxoCw_NX9tfMbdcg3w,18730 +click/_termui_impl.py,sha256=a5z7I9gOFeMmu7Gb6_RPyQ8GPuVP1EeblixcWSPSQPk,24783 +click/_textwrap.py,sha256=10fQ64OcBUMuK7mFvh8363_uoOxPlRItZBmKzRJDgoY,1353 +click/_winconsole.py,sha256=5ju3jQkcZD0W27WEMGqmEP4y_crUVzPCqsX_FYb7BO0,7860 +click/core.py,sha256=Q1nEVdctZwvIPOlt4vfHko0TYnHCeE40UEEul8Wpyvs,114748 +click/decorators.py,sha256=7t6F-QWowtLh6F_6l-4YV4Y4yNTcqFQEu9i37zIz68s,18925 +click/exceptions.py,sha256=V7zDT6emqJ8iNl0kF1P5kpFmLMWQ1T1L7aNNKM4YR0w,9600 +click/formatting.py,sha256=Frf0-5W33-loyY_i9qrwXR8-STnW3m5gvyxLVUdyxyk,9706 +click/globals.py,sha256=cuJ6Bbo073lgEEmhjr394PeM-QFmXM-Ci-wmfsd7H5g,1954 +click/parser.py,sha256=h4sndcpF5OHrZQN8vD8IWb5OByvW7ABbhRToxovrqS8,19067 +click/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +click/shell_completion.py,sha256=TR0dXEGcvWb9Eo3aaQEXGhnvNS3FF4H4QcuLnvAvYo4,18636 +click/termui.py,sha256=dLxiS70UOvIYBda_nEEZaPAFOVDVmRs1sEPMuLDowQo,28310 +click/testing.py,sha256=3RA8anCf7TZ8-5RAF5it2Te-aWXBAL5VLasQnMiC2ZQ,16282 +click/types.py,sha256=BD5Qqq4h-8kawBmOIzJlmq4xzThAf4wCvaOLZSBDNx0,36422 +click/utils.py,sha256=ce-IrO9ilII76LGkU354pOdHbepM8UftfNH7SfMU_28,20330 diff --git a/.venv/Lib/site-packages/click-8.1.8.dist-info/WHEEL b/.venv/Lib/site-packages/click-8.1.8.dist-info/WHEEL new file mode 100644 index 0000000..e3c6fee --- /dev/null +++ b/.venv/Lib/site-packages/click-8.1.8.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: flit 3.10.1 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/.venv/Lib/site-packages/click/__init__.py b/.venv/Lib/site-packages/click/__init__.py new file mode 100644 index 0000000..2610d0e --- /dev/null +++ b/.venv/Lib/site-packages/click/__init__.py @@ -0,0 +1,75 @@ +""" +Click is a simple Python module inspired by the stdlib optparse to make +writing command line scripts fun. Unlike other modules, it's based +around a simple API that does not come with too much magic and is +composable. +""" + +from .core import Argument as Argument +from .core import BaseCommand as BaseCommand +from .core import Command as Command +from .core import CommandCollection as CommandCollection +from .core import Context as Context +from .core import Group as Group +from .core import MultiCommand as MultiCommand +from .core import Option as Option +from .core import Parameter as Parameter +from .decorators import argument as argument +from .decorators import command as command +from .decorators import confirmation_option as confirmation_option +from .decorators import group as group +from .decorators import help_option as help_option +from .decorators import HelpOption as HelpOption +from .decorators import make_pass_decorator as make_pass_decorator +from .decorators import option as option +from .decorators import pass_context as pass_context +from .decorators import pass_obj as pass_obj +from .decorators import password_option as password_option +from .decorators import version_option as version_option +from .exceptions import Abort as Abort +from .exceptions import BadArgumentUsage as BadArgumentUsage +from .exceptions import BadOptionUsage as BadOptionUsage +from .exceptions import BadParameter as BadParameter +from .exceptions import ClickException as ClickException +from .exceptions import FileError as FileError +from .exceptions import MissingParameter as MissingParameter +from .exceptions import NoSuchOption as NoSuchOption +from .exceptions import UsageError as UsageError +from .formatting import HelpFormatter as HelpFormatter +from .formatting import wrap_text as wrap_text +from .globals import get_current_context as get_current_context +from .parser import OptionParser as OptionParser +from .termui import clear as clear +from .termui import confirm as confirm +from .termui import echo_via_pager as echo_via_pager +from .termui import edit as edit +from .termui import getchar as getchar +from .termui import launch as launch +from .termui import pause as pause +from .termui import progressbar as progressbar +from .termui import prompt as prompt +from .termui import secho as secho +from .termui import style as style +from .termui import unstyle as unstyle +from .types import BOOL as BOOL +from .types import Choice as Choice +from .types import DateTime as DateTime +from .types import File as File +from .types import FLOAT as FLOAT +from .types import FloatRange as FloatRange +from .types import INT as INT +from .types import IntRange as IntRange +from .types import ParamType as ParamType +from .types import Path as Path +from .types import STRING as STRING +from .types import Tuple as Tuple +from .types import UNPROCESSED as UNPROCESSED +from .types import UUID as UUID +from .utils import echo as echo +from .utils import format_filename as format_filename +from .utils import get_app_dir as get_app_dir +from .utils import get_binary_stream as get_binary_stream +from .utils import get_text_stream as get_text_stream +from .utils import open_file as open_file + +__version__ = "8.1.8" diff --git a/.venv/Lib/site-packages/click/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..984f080fec3aeebfbbb2a01259e9c09921a49ce9 GIT binary patch literal 2756 zcmY+_+fExv8VB$;_-tb!gq#UYAe=FWKmvq7z(B%G0&IYrlBHI=U9mg#NmcD+n7e(7 zeTIFOeSnoLSz2kY_HI|Bx!J4zf1f$ba`ER^UsqRkSC_m0*4LLe@RvL7G~%LR{F53t ze?8auZKBsO{$kV(Vbl}#9xvhdh@J$w7w#3k>?E8NNp=cOi4;2xr$w5bfioh*&ca!d zW#{0W$g%TqUgX&YuizI&kzIuQL?62kE{PJm1ow-6c0W8I2G|4epcrHi!uP~I_C0t= z46%pc`{F+PK0GXj*~9Py@qqmRekdNYA9|1c$Ko;j5&T3vVLyhSil^)+@H6p@{S+P% zBkX7JbMc%#0*{JO_H)=2CVLbf6Ju=Cd*P3ZarPKIAtu-_yqEr@m}HN8Q~tD=W>0uC z{;Zf~zl7(+9D5R;7xU~XctI?%r{S_FvuEH%vB;i|OXs9I^M{pTtk>3jDM98QvG4t`24ne{JV0p6gtit~PB`yME+J^YkiihJopa^%h!g zpd(kwx>>t2*#oGMZ z3d-h1;JKI53^9tj9$n9yZak&UnyqC$Z>z9{GjA_s_w)!;+Ob&=r8a{wropB8!;PDm z7W1~8CMIvVj!84RI*;Q~sO_33%lUsL@IIJHw6nXa(eh;w!-YLeROwzJnwdKeUb7N< zo^)b247$gISpGt1ras`}BB1!W<;CvZiRqK*x_9o>R<QjP1;3r*=oclG>7G;b#uqJ_31TWhN>olx0vNK>V6hbi(gOmThDS#F25 zZ|K!e{t>GB-RPz7QtAJ{j@??Q=ynJ8?E1~RU1+-@Q7fU=y_TCw5tTpQbcr|9!7q-y zxv|`#>&XM9_(BIhyINz9{PC3Had?Kuczcg|9{c8uKDz(Ikk+fathpb`j;!n38*0ed za#~8^;aYchUF;5qSu{V2l;cU877EXS7oYA$I?d4f?%G(+2KP$Jx=VMS!Jtl)`=>p- z6*x^4Q<2@$v<8Jpg$*UOu628$=|{XjG>u4Ib$sPf*Gwz8VRG-}P z4>Ztu3%_HaaB+P4<)m_Oc6P9jX7b|Vi2q+-YX4VWS?eq253qCT3|dkg{Y znj6^a%F?ltwvS>z73mS&m2zPu10Lts)OvZjyna0Mxt+1BdgxeIJBht26+X&_N>ZdK z(i9nrEJcojzU``jXy)|@MA1(%Kru*hk79`8KE*J_1B!=;c3$3WMy(!E z^)ba0il-FMC`KrrQ;brWh<3iaHuOqUV^n=X)l9<+YqqD=IJMFdZ!tB&4Qx=q<*Jv| zd6Hs^Vwz%xVwPf#VxD4wqD-+!v4m)+VmwlX3zl{B60rVi{DzY8-*1)8>IHr}x@x<1`o z)uC_AqGh>(8(UU6x@u>)x}TYCb%v?wjjjKV_;+t2k@!zfDv|uXWF)3K#(c+^=ossq zX2&RZj29han(MP2W3OXOc8rydvBXAwl@D$5DLAynKoKM0Tr^>He$CAtHU>mb)GLzjBs;?D>#JW0vjFH*c*(Qf0Ty*Tu^_)z5Nd$VGj8K literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/_compat.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/_compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d1d917d618a0761a116ef6d0cd78663665d6654e GIT binary patch literal 27467 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/_termui_impl.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/_termui_impl.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..81751e927ee0559523ae6b75e7ae0bb04fe00bfc GIT binary patch literal 30602 zcmd6Q33MD~o?lhpr@C9+y06x0$%lLid|@*>d}3s<4GiKCZB@%^Sr^qU+tNrN6E@QV z6H5a-YV9zwoFzdl>|*kEgV}5rhGWLr*}SOT;;CswqIt_6Y~D+nmGg!$c}af%uez#R za><_A-Mpl1ef8b-o&Wp$`sa4Lg~MZh;EU7$@hOh`3kt}OIptaYSj%x!oWQkl0xxKK z_%@!sHEkO9*0yQcTi2#zZ+)Ady$x+fytO^1UQ?Tyr?R>pORu%f%KZ8sTd%#%&isa+ ztX@Z(1Ae1m>T&kE+FZsV^Bpy@OSCC}^IYVS}_slWP8b@|tInuN0Fb!~P3NOgHp z*LtBGJ$U%m9^By@ckZ`Is6hQ2*@#zS#H-%aNMC8&By1I`(cc>XI$<6Div9KISuI9s zvrvcl;x)!}3yo=~PFRn6xBBzN&1^+)Yuo1MyE|2SK=pLp8t<=X^=O0*&+FbyCAZxr zY-BB|M*W*m|J_5+b=!vDx18(>1iiie!eEcz+tJ?_ z@&)>W-azj_kH6QCP$(~a`=3Euub6q3Gx48EYZ&+ixfLcQfH8pPH*K4CoV4~6{aL-3kTgv3DK>BGn1 z*PrVObacUEKPjT}Q@)NfCx-_7U(qf`tfyV@clrikJIZXAs zP;dJwe=yYU@9XFnP%kA1g1%5_2tI57fWHsrM8B^WK?{6=fp%YCFo2MWhO52D-v_@| zsxFI-%l`8n{sHPb5_JBKuKoo7a6;1;O7QjsZy7e)iypgo+g&}wM)vNqbflIFdzGgG z%TF;d?B@V}xi*cNTl=4|UeEwsnKG-9{D@@$e`Si_K+BYY5$zh~j4V~>Hwk+D8SrPs zpUH0)%xjb|vl15Mu&$9q+wED|4hpT2m$mRTzecKwzSXHAmwnZCyL^IujZ|%SF129g z!|KagqlDB)hu^)+ z>SV2@c9?`beBULwkh4nVOKdzlH9%0hHaBt^;4gsRBWx53@y_w*A~p}PMHxUPUx_Ww zh%HcJOEO{$QQm~|rKqhaV#^9%Y{uW zre=-)vtF@zFbL}~4;84V7Ue2Y_wC1_4!Np^_`3Rp^#QT}wCE28n|xwx!W6)!_MPhS zCk)uwr$b!{b7!EZr@f=gCnhZZ-ht4N@{bIs7I3S?j_TB(N zAOAoQkS-vgH3rci8Wj6FoEdX$fS<^U<-YLWy$cT_mE;wRBNUwy<2+?=gGh#u=sD!NN`Je^_7LQm3294Opazk!8kBkgQZHTvo za@68c+A7D7*b%ZRp)7>#a!Al1lqH8o90)nmAwfd~8sd}@8qtj93K|fmuHNiXClP-m z&Jhr&GSM)q8PNzjM%HNr4k3Q55oN5Qb#kqOUM35l<3n|FZ1;NEmwt!vZRzRWDErdy zP`&J@eH+>;hekAV{Ysno&~_!2ms8OzD#)G@8ihhR#KxpZ4xOg{EAVE7;}Pb$&>lHm zjr5gg=seA0shku3GTATCYVocJ$+!y40@5m0q*W>*N>gA`=sr1qgj0jRa$jv!sz%Ps z>R0Ath^sTUCODB6GEl5l+NtebfxggJ{~OP6sl1E5AZ(;m5FlP6Py(V~I8awB($I-C zVj>NcSV9hUTcrMqUUH~+B6UinRV~ui5UE!pbw;d)0|KL?pJ=I&UuehI{o+|)Pf(<0 zC(ORVP`|WkO`sw~U#MRcX~`taM562$MeK7vl+bnff&dSPQ*cMjrYw5V*LT{V&{01` zn)8H~K!?_M_H;r=G+06(4EaQq>p^J-Zp?r=?PvNxktIx>fxbYn%P%C%y}tA9QX`Cj zLVk2UVe1$aMFiRj4vDno66QbNIu@v ze>(X1DY)&vfr0kk!85zIJYIj+-*@)$qk&V82hq1p1E2ERL-MpzFp6^A_ zF27dAmTsg>Me)M2-`Oy;4H+#*^;lKsL+ zyr5*l5VyMLtVMB0PWYL{+_E|EcVfAXbI!)ay!@%NlV@M`UGARle#tO$C{B_jF&a;_TXiTS5U7_pP6j+zMh3jD)6$!H*98OwOCmXE@0fw~i1ou>6w??JTKdSmOTkYD-*-6{!T_Ni1<2XSOex3ZtgNPff+FGb^TqhMY~w z06eVCc&~nf){rtaf`YZ4!}N74ltj8rx`#+tsEJ$C*>rwe|7iapV+*~Ze&R2^@_c$h zh=HT+^ZLB!0--K1U_!^4dJGSnecSQDK7yAF+=>TKd%~;$5%D0xnG1nHg0v1+g9Is- zvJ(!+GH|#rjl3|jm|Z$ob}W|tz?|)Y_{t@5>6!6oVve#oQ`xPfNu$9=lkmY57gFXw zJ$@scj0xrU2~NBp+3Pe3T_3nvkv4}~4=C|gpeDtRp-hmdvN7(a4e;lcmWb!&BWpF2 zn#h_t0nb{KF7iXPglSQ)dekO8q!5vEw`j+zmX_s_8MUUD%us4D^y0lpXJ{EDvWVGB zm>UnA+<&~isquJ1-`O)5>{>lYVk?Ra7i8}A6ld`YAU#OifKW!v3nk#+l(EbIpy6tWM1`zl&yhrB0^-gHi zTOmW_Wr7l$NZb0?QqknSBGp-^7l|TFXu)KNcaaan)$a>QnEoIlGPj0ypd&Qw$Q(07 z{4>f#MaMYcwo7|o*c*4}E;_O&8m4wm?tFD{=H%;-U3u(A^<7sRV`X>WDBE+bJnFvZ zT1U*$G-qnMb%7Vl%U>E^c&cARza~NM7 zeRc4)6SJPT^WVt--6vvY+oO){bEfULj-Ikz$57Q;OYXup_3aj{LA=WHLo8}r{UBD^ z$mz6U3-%R8`~)||i>DBeAtU0ItuxV2K3Xid44D?B>&mr-h~GiZATdGG+S)U|XUY-Rlvp0&nC zeCSS_QC=ORJUB>x7-K;EB7ERLGvc%>;xsIu4sjYKpY}`(1_FHOk2pa$q7(E#(t*Fy zrrsKQ|JZnfTO&n}5jNJDTEDsnz4?lf=LCO;HG(&x*|IIc?-q$ot<#FT@k(gHnuxTH zvE_;O5w}pRG3bXtSO_MJ004s_KV%GD{exmKNPC88h!hcFfpoan$C!-a+{}fXj-Nq^ z;1A&_5OdM#o@kjmGtf z?V7mFG4bF;XzF{D-<#;2b5})eRpDlAld$F1ks%PkHp+M4x%0?i>0`Ob<0ELWjI}?8 zI7Q$Ji4NDdekGuuVU4#T!BnOq*}*p#lmHV4&9m1s9Ir2^6dW0y9Pf zGp>rUN7$H=*a_(XnX4c5no%kRUfF6wX@Cc=TM?3_YY~gq_^vw8MvJK}C%8~rjP@I} zOBViRu7gpCAiIgNSoJ_Sw*#~O&>HR2rpG)jI#g2{puCFcUj3Vy?Gm(%D$)(3UC6D5 z!ZPNMfUBVIRzz;;&Wvc~6)%lkouQSjZ6=YD35M^aJWKaVz}PO~!t~;&MVui~VZ@lO zCqUXJq$G3zx?KrvM}JVF&UD@VfxZ;mm#~odIVGXi!VkeQWF^5>{GYs?kU@1jA^sXZ z739HyNT6E+7>fnPk&~CdJN?~R-P@KoEYXr}v4ZX4Bk}Cqsrt$KncdOsO#mQ(Dh*Tj zPTo5syxx7K`|9p!&EBYcU(~iQ+?*`robIqCS-@pwUwYz&C*+b1ukXGhl}_fe95>xu zPC>+Txoo;@w&m?3Zyfo(W1tZW?umK!0u?yi3yzwoqh_}JhGPR*)SQB;*2&hSm2>4T zdh!+vN-pP5=g(BVUVEi>_T<8*mMH#Lw8RSbU)M$p?z`R*EqE|qSbBN=^!l&0d_ncH zR-2RiwN~%SMqTclsdbaSDm5nfh zYKmAkqETark^440k-Q?oPw}^@0c7p!N9L+BYEXwOJJ5ox)upk9Hy~bRw+Gkm2eF{5 z9@SQ;C=4&u<7+vq3L}VE6__CR2@pwp!L`P?D!ZBSqC`%udQdk>e^xz+C9(0UNA3qw z6)}1`OLuwNFZoucm>itd`WywBMEn`}pmSns?-b}^pMk`f6kewS zp&-1Z&!X@u=;KKdhyy9fTRRDrhrKE!GkB~NbHoF-{z zM&{P-iI-Jg9-SVYE7}-7D)XPVoCRBP)JE{DeY!nXQa^9o{FyZ`t`<+#foDb5Cx7S3 zt1a)||F7>~E8l{(G-@rKv#yWl7cb;*h~{sYZCTj3H@b0eEPr44aNLnU=ctN13l^N- zsM9-BFz?)uG;ns;f~_QKD_H`hDx5Ba>~QMY$!BAEwW#H?ecHZ|zdoA3es)(Z|E{l% zI!6{@lRfK~HqPoAuX(XH=`fnzx6&^PRH^~3M$%D%>ycmypw#L|d<5$d`Bp!OrFvF9 z3_I^tPlF6rsXwH^p|$d^LD#5ID{pCJn<$+)Woadd%27%6wnb}Cd*ky^-!^D&tRm)-GDYK@FAo?1-S))I;uGZ zqN2QV+tTk$iUws#rK^k!3n^o<#)v_Yr&jL;n|l1HLA`ydJ-O|ej~X*($0+xI6sl&` z_CU3(7C&NQ<7;Fp>U7Ul$8bdX%56s3Fk+HvYq?EOXY16Ua2i&R8cAWUwzt?W+RxPK zYCDEXsZ;$byF<{wWq32Se;IaCDcN0}UK_IS&6J1s6jPT<%2G{QftldFj4nL@TteuE zX*FS`)Klk97=m4cp+Ju$Tm23tR**w_yL4W069sF?q3tS;!+|i-cV058B5hj$#$WBh zz_34Igk8g6Z(mUSEy`tS+JE5K@%<#D6^Y6g3D1a+!KpJ#jPOg8O?zsvGhy!U5mGA5 ztd5>RSb-^ouer~EE|p~M=<$OhmQJAO{9WcX}>8JN_(a&h=N;-*9YzE2Yt*&GXJJ@p5WeR=l8szOZpx5)`xYA?xIM`%lpD6rBpe@x=&tt@@m(O>V5H&YE<2tDn8LLZ_1BL zRZVP6K1uypM>cR*kRwehD$FYcE1HA%M8s*|@_*UMfs84~} za(+lnu-Cyc<4dGtNei%VUsHw&k80b+&A)CgIg;vZ2;3megfjksg1Xj|;u9F(z_&0GsWYX;ZxTHW(F7;%B4;N#cauZZ zG5};F`KRH)B7)4ZXpI4!q}0c~zB7JirnORitVFv3MuP952zYF$kxVa`CJshTMK7@} zC2`y{q1Vq}Ie)d`-97K@xv_3vyx5B^asQXn;(zhJNY&*{)0?8Ub+g-VSnHvV`VvsY zJZ=7w70PIP(t_=DY3B<&7d`n?hbIree4hlLqMnUcb?=(qF-6@w$6LO1=S}UJ-1YJv zK#0OCg;Dp0aLW?nps9g)wRvLiOv}vOQJ5w`*G~j%(R9&l%Ul7p{4Zs(Eyvh|4(hu6 zDBCTL7;HDq1tYUdlGCLPsIpa*4TzDE9`!ASSQX-xZM5x3QzlogWv#85M(Zf05U=S{ z@J$}hrL+LFRNUbb{LdYQ#Dvk&(5!0tKdhgmg@ub+A<(=g|$r&3nguv-F}Q|f@g zH$bMv^%f;+_kd6I^?FnAaJRQr{;>2xQkY9E^w+O0lljHn-eajod5NQ=V$?KPW3O(R zQVVrVwjGx&76q?L1MBO(XJOZaRzpYyyCz}xZtu?eEi0;Ng!Pf2J`VkIvsgc2Yb9oM z{@1Dd7@3z#_}zQ1%TM;_{`B;uMyc2D4+SY@MYEoIYPBUMCMMJcd(ke?CF${OmFO$I z#7b|(%3=m$;;ZC404EcOuuLmqh(Y?yaCRn1BE{7a^f-koV5Q;ZZ25E6%D8u9xMd!E zC7B$Q-!PTWJQ6i+{M1wq8e_p)6}48)>K1DEMr-%pu&~h!!=>+wMZl zg3TMXdFO2v@mkm-eQK*F%)0MZW|Q_V?egV%IIB%@m{p##SJ=)`_Bz0=w)MbCbejnr zn1q2OoVSSl4U#>}%AQMc&D3)e#{g~?lmaeg5nPlkuVA3`lKs~9611qq-|}}+_CAhh zM1UF!zm2Vm3d9j}05?<^=KX*d-^2L)P&1|Zr+PiUH$^-n zUHu4JW{v7ZD#(=8Pa0N@@IU0Ic*YheqWg4iSh%Lva=!*aFo`)RL2TfyWZD{-M@atE@j^X=wNm~*yUs%9ZYXb@j-N0+MSa6$;=Fc z#N&vT_#0+N!`3I;wzOHre@@N}oRnfNp%Kq!>gB`}NLz{Rm2o&ktCskezu~^Ymdz)Y zVU?+n%nCprG&DIR?M0%_1Fr-oH1VpM3EjN299Z3xzu?{&b#J`N-*9h@Bjl-#dTQrA z>z8u#e_)C`JyX_6YozhFvywSno)@38yDr@~e&0oiu~IwyQ(Hx{jI)=2%j~?K+upRE z|0BMsR`+ij$y=Azn&2zN7pXJG>RL=rT@boD@5$B!t$5ggeN`$A!#c{8l>wd}d-w^A z4n?<0hDp_AQrYK&^+P+%NZX}DNATO)+n*lv^++j_?%5=x8gU!SGn-dQD;PpBp*z*z z-;*#k13gNn_$Oh~boiLqOnDEn9ArY9us8XFe&w)@NV`rvM#+*jEg9UNq_{`OX=Mpm zPB6^~4KV`_@hM6mWed}ei%*j;EiQeIg2dG_04{-YWnr)t@CGLlMopB7q)5!6Aql<# zNccPlBhSip@q*%bVM)BW8mu3TGvjre0L|hj9*LJ%$E)kWLB_r1@tnM`%bR)qmZfa> z)cVQwkq0lgO}D|?^NDEohNPZSz%;qCiQkKCpL8UREXu@r@{(rewQxE4Nh|Z(xV*xo zoq4l3cW%=ybJwNe@!?42__N6Z7FEbOoR_-C zyCW`A(?qi>l0_`OSk77%b(AGbSX?PrRGKVfUN00wNj4VA3eJ+XTuHIZM>JZ!CuuS0 zOVT6s@btqo_d_`q&EB5WBLySm$(h!vT{<#;WMVW5Bxj~53)N~R zpHrvzM#@P)H1pu}rezMnq|HEa%N$D}bVD``Vl$(@s*k{n)FUGEmYQ+TcMoe~zjUbRfI%MDuUewn^9 zvi0)r>D@EF>Ag2O1f^BX7BB%eCJJIZdj)f?M-p%y%yQvong+-?gp{E;-9dTSla9}@ z!%}dg8p|tVEYX@SkrufH?IEjNH}M%Gyev9~@>*dT)l^h!m=9+{6!W;05?kAS8^si< zki?3RqLLD`(t=~O1vWo&YeWYu)C!cAu1q8Awcot03N9D)XF2h9-}T{EP%^P=>5IE4x9_=4{n3KK);A1BRx3ECNU%KjB_irZ(wsY1S2n;f(_6)kG{d4 z9(>O)CNwx&V#LvjfY{%c(BecaWx_#Mk*LZ<7CYufr_-d|miB?bK+12T<8P$qqoc7n zj}jykY&sa*JHU>!8GFxw>FphWc|uQr5Qpjp`yiD)Q)gu8QxZ8Fq+_`WGpoM6qgN0= zrtfMx1v<$B0WL_2AhG(yZsL)oE_#+-{By*U{d|y^g)#0+dwI-WId%YW-;_1>%%ZE{ z<-)MxORMXZ%Bi}^x_N8yYX@fUeyw%UQ4pz_shfQ$#*8T!UGAyE$-=49$Dw zKYui-(d&yBtvM5cncUf&dFy60=O*g0lF{-+?Wd-qn|jV!sPy?ulSN7S=AuUNe;cIp zM<4IDgAD$p)CTvbT;72^*sEb)R>*!xV9Bt-A7CeEVgo<}Oa(mzF~@iucZZ6uhac6Y zVR{B+QW1PA<@HdEFaxnV+2jy&a!K>Z`HiBL+cBKua((-s;HhThOh> zPniU>{8dA2FWAc?}_p-lB$L z0WnqZ&xrOkFW8W#Kz7z~=Acf8V0+8?W(uo9m1a^igBa5s;hy8o-~qvhuE)%nM>ODo z(@@;3jJa98hVG*DS7qObQVJaAMjasZ8f8_~pfVmHxX#K|%C)B7nR$k6fVjkpuqWhA zd2kB6iW9Xw_b7L%HE?eP{d6Fgc%v01<;g=}Oq827%LEA#ZSSfZdkB4)cN;Ww|AeIp{qp z4&u6mPGVxg`}X#dIPe^#Y@PjseZofX0h}Pj6$|v`a{>4$In*@>K3Zx{#+M<38teh* zi%d|9;cPNpnLrI|J-{%47{n+^hG`qfcMVQLcXa=W6AYIyzVBPjrsF3QJdPqBPZ&i% zyQ85_4+PNV@97c$m`Z4Y8WIK^MC=!XIDH751Y;8-1_AU3PhoUAfO3G40v#doPv|@U zj?!Q?GJu;OP!qkxKc$3cC_(=KU8<1KJ#hGe{pFX}a(+q~jK@w$rz2hW`G-#R z`$XX|oz4;m2XI>QoG%cnvqmJ-*Yy1m7VpAU#OJ7aB0>VTeWi36&;i5@0O&G#nh3$>KZ(5%!L_pPs~y{)(o7JokM6O(mdmexhiLxqONrdu1!(brkHE<*pax=HZ}?~ z<;Llf*_s;#TNd*fmvuR7I&0?atQgDRHkY^kYV*5?-Z^xw?K*#5bM47k!_m3z_s`|D zhAp2t3ZShEH%}PG?}I2{e1F{ToH!D-m(Enq7Dg+!BQCsu$&|fd%8x<`XU+*{#j~>G zS^1ax$NOQc2NRXJ-IcU+=7MF;Xf}*BCY_wkerd<}jyYJi=wRGZn$(!}`Ja1A!Y!Y< z^B42VXR2a(>u@*`*$$2$ymbHg{gJ9qZDn7ZxtvmzHd`(k$Bmcl^`s%STtA)Hr++d=BRC8kqhN$|1>kIqrOUSVNVv`KZk@|n3 zHFE8B#^K*r#S;Mq56H*?SJ-%cpx5b^9G?hG0=o789o(4q6i)n46whEgL1^)3aO$k9fUx)rN@B2= zed*6A_;Ydy)Z%Dt>VlmF-x;JWB12ugCBXXuGYusceNH(Ek z^3+2yXZ5_P=9gN|Qk&En^~G^hHl6#66wjQW%il6@+IrJMl(lKxG?9JLwkVU*IP48* z_scvKn=`Nb)lCy;bN?Nu(c6Ckc&EpkqEyO(IR7@d1>OD0mh$F&?T3Z#<|^)^e0_7d z@uMnp^A_z#n>5YaxsNvU3T?O{;*U+~Q|D=6V)>Hw_`X;J)J%0bRIv?xflI>s%V zI2X>zf9CKkx=SKL%v~970grUaHg20Z`KhV!Ya`N`OsfO=l}Col%QjRs#jUQXXU$uVa2=Tq-?Cv|vl52=LICpeR_uG`k;o@o>c))rpzka@(jI~} z71X$rY>-Gm`5|tMtvcdxXw^Z>C8xnIAXBH#?x#s{Z&-(PKaH~bXUM#gBBkRmZKtQWwN-u5-1dL#X&CFJ193gz*0&!cj!>| z3W_MZir^m^7Iovj`e6o?t0NIU0bGk+h{Zd~hm@YHSvIIqAsPHM0Ho_{2kvN3j4}4xc;*9spbh zggZi=cGwZ5*~VQ+o1`_7(4GzS;_x{bk%Z=Kpw1vol0x!JG(K_84C$oo#S_{y{vq*S zP%KScaK-jcSm^#Wsrq48YQEA@4w|v2P%86q3Qm7c?U~#&XDj{OT^(-D6y0cJuBvcT z!r_YN75u;qQqoiN-vNakad+|Oxp#*TEIK?B55G7H)3$hC$q(#FJ(srw(iW#j5`Yu3 zS|RZ!p%Yuxa|~jnOsz@7tE^b$NIh?+-Y`h!ApKOeToHHOLGB>KD7jL+m3m2{sz^E0 z8Pva&rt?78Y1HHyBU(r?aC#N4_Q!MvRri)&mS8iA7%OS@qqM~UNe9miU8~Y`YWiNM zv>aKL8r8m~nB~gtd=4gVpyo*1&mPcv8#2v>GwN2TYW2EDjBhD&8oBln<8ySklkpkj zIbNaeERtFn3eSoJUqKg!5YH&i!x_&1p0p@OcYA4763^cWCekm|@oX6nm#mdxxA%Mg zQPf3?J;D3y>=H@zE2^5+uk07lR{aA*lCF7?l9$LKgXRR^o-jzLm62YsRcoZQpOeEV zECvIK&lbO={J3od*L)DcCjKvkg9H``htea7OU=}ub|OoMovD4M#FWrBqZW*DpPLGn zTsc!^lVveiMc5GE(hxR+sA0xsxlCs`)j!!E%Uwr@dEJs-$>p8XJLhdxNu9-<6L%J- zjzAok**UvywrjTS>eF-OyRMzPF3dT-G3N;!{>?AAY?wCu$Rt^^Hokx>YN{4JIdi#N zVxFxFo}E$8&JPT8o}Dqz!DX!`FFVO;aAZr%IZM9*1?9|xqRpJMnC)G3y5_RC#+=(0 zoV%jVT_5CL-#X{q6?5K?QtqrJw+B?0J?B?REwXC=H_bchr4T< zz1okwdiWXXp}zND0mM>{Szx~ewSs0;+t;1ebB*vJ zukeNP7eP(v)A~8J8yCCF(s^ZHTE}#UvgLA#^gCTvu#jnNdd|^OMP94glH1k>nX&32 zu=Mws)lXHrC9)3~<{$9g5lK2u`n2>o*T{9J-9>MK zOt;Lgf>-ajr}CaP{rYV@!98p0-jr^E>`U(t)!l`|>~e2@lW(n-WlZoFAD5*WtE3!5 za{RAfzk)^hTuV8rIk?!{)(I=cb*Tf`QY+dgdKA5}@xFHxacrAo@E4=fOA* zcH%Am6-s?Y6e$dxPSxc}iZ@Fjh)aS)Flog#bEk&rW(YIAe4^;XwP`q0$kcpHJ1EBJ z<9|&KlPnOO&IAR(UjoT_C20a$LYLO*2Ixq$2?QSQMM0Q+z2qYaJ||K7Kcm*@BoQ&L z-4zlB0ryl0e)(hw2@|At>TpG-Py92MpLB%c-;&o%^`Z5>1B~cYIsAb;c`+cv)(kYb zoiN}Zq78%r^M2uQgD)6wA@!aPm#+loO1I40w}S8-Z$TQ)DBM4N|7_KK@n)D{MRb$4 z3Ef{hvgvf+$mGaO%WO?7Z|g$d&S>7wYeliV{gb*SB;oRfnH{mb4G^cwioDrf*G|6w zD`0x99(EO<(`O%Ht=M=~aamyX?ZaoM>OLZoHhRX+1zJSTVR;mL|J6-rMkU_{4`bdx%*j2ph5K+r_MtrOhkKj$An;R%joc#Fp(^c9Hv{S^<;Ls9Ch}M54{b7DuQQT=OWt9l7N-PSPY&zqLr`!AThJ#~EADhT5E~jg@dXy zjjtcNawuA`Daj%3YWchC-&ud{!S}!W-gl$h4&007Xb%(KXr2C~l3WD=aInraq)CpQu z1%*PAq7MqYC;HKc^|$mPJ1zWIC8E^GIc1($zt;)bcj&kKAG=q?aEt4I^Ompdz1*sl zX_{x0>ocv)F}lVo6JV^KR@i`)Q@Zg;ZZl>EI}`#o$q)-aUohDB z^dJOl!$#u3cW>VOl@V3q8YmlpXHVc%J&v~E>f17E-ba+85m{3yBGc|XVQ){>B(d^k zL?^YQj{18D_Vxt#)vw6VN$7>>_c87ZQ|*#9>(ajQeG!;JRehFS5UGs#BBvtjV%Zhp z<|XAiC=gsem>%?r_#qaMl$#zA=TO10d9&a@yP1r}68t$_M@nW}P|DMlrvtdM+%FEB zHsiKn+|;{~ou3=lZ+@il@JVKA@YS=ZAz|tmI?b%aQ0ch@Uq5U*FPz>)J%D1t*cA#5 zU|@z#-R@4j7*%rVJw3+S@=A38de9L z*MSj#M27=DpIKd*K{`EX9k)*2KT{d=)XbaKEjrv2_szIt4%`zA8)b7r++89WiOsZJ z^)R~f?gjUrsC!S$y_e`bSVF&a^b4~M6@QjpHlvMY(^X)e(wW-X?X%T$-Ys+Pt>Z0A zo}!6eFaiJ_oH}E0aNb!Zw?uRCnC#Wg+lrGKojDKRWmf?;#N4%WwpvJCEzZ^7cun)V z@rvY2Nf^^ST&Xv^1Y@5S84Yb=cb@$}mFYgQ=i#wd(B#-fQeu9nA zuWsT3BgmOF=Dc6PfL@RHuWrI_eRWhJQ}G$}uDGk6hcjtM)^CGEDE{Ow@4+nYqaDtJmE0#4&V$>yPZ}EYadzZqS=k4@+MiXL z4{p}}tez)#oB7~A?a%h|aIf>*5AD)k-^s&GXga!9z%eW~iPky`4=E`iqOHYRwxrd5 zGJQdp^5SeUr8?8pSJ09+(OZ!-bs#C76Ll(ZF`bj0u}$#W1g}f*g*f~5pJ_kQo=lkb zA3MOTdLTdr)Q7Ggu_@W4r#*!G&V%$z3ixq__E0}=E$$HSLXO{~O|%0!p#U(N!w)|< zvY1sC%POD4Q8y|4?`T^giZ9FWA}*D%?9EQwD6Cqg;wNer+skH|3%aPU^0Wl&D7}G32EgGGUK$(sUlWs05^? zRjyM_;{5+pd(Uw)d5Km-_A5PVY>Gl8DT@sW@f-@W4u7Z-J;R>!elFXnRbH1kS`wfaP5O>qUIdfm>mPtuNrP1-x6*h_glfka%8guu%`JWWzwCv`7 zvbmtSjQh~kNP&+^G)VZUtTDf3hxX$gT10)k+r8hZ{lrcQpE!8(JGJnyKm`VjC_@ED z0B$l3=;bW|0eZ$o*J|K}Zk?5-4r-3g~|7N~Og2;WaVGQblQl@;B>A?{3rn~d^K zxm5Zsmlw-!pHJ1iJ=3&MQ97(dPaRO+(m%PcB>z|~WFL|b*=Sq8@}g->G7Td&Ledfo zK-X}H9&%{6W^6SAInrKvlzc>Zr0|>gXB5Hcl}z-;uo`o0hz<(KgxhHC1s9);h$Oqs zo6L)3M~=T-w%}R^8{qlcU4K&fe%*U@vD%go0x{PE;Uw6 zj^5%xH5qAxtrSP7`F}#rd*l!$l`!Ddio`c zAUju!>S3!6@x64Wi1Afy6xrA@vq4f%N;g36DP^nMxQkvq+fXnbVw&^w^2M}|7OX@B&~l=zMqiu0Xei`n2neuSM8-B zv0&owlaHoT+yf_(l^PkC+|#)y@ee4Otq-D7#3piD$XP}8neLI!GVc=~K`Q=(CIw7{ z!7|T(tFi^T-#>ieaJb{2w2tvhTK)HTT-Xs7p1U{h%7NLq({thQlB<+_C1Zzg8os0F zD<{h7I8&r?a^p>o!e1Y-RPn_V53>8Gw3F>g4#C+6*)>YK=%&3ad>scx5uI%1_wmlu zxz`iZo0A-ZSGDYQt?~UM?;ZId6usvt3(r0H&@v?_n>3ZY6Ks-l##f8*k{O1Lc!OGl z(f980-4jC8T9hX7BB>>Rc?H>G&Ng2ulft`pzhC%X;Rh|z zT>#?9u%tIH>+$}j=SiL~{+eTMleUHDT@#R5(>rofdS7jj-XB1&P4UTAjRl=Mk>v22 zdGPhND{WWp(dvE66#lx9(-}Y4xt8>f1$}80=V&#&-jyB+vQBr=G2JqjkTh)4XHN(u u1ka8HN$#D!{1ngW-Jk2SGOEa5Sp|ZrD&R{tnDkJPBssjO3cMHr`+op$#^tX7 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/_textwrap.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/_textwrap.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d6c50d46819fb90db2a3faf971857a3e3631cbd2 GIT binary patch literal 2463 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 S$5!&ot+vC2|K%PI=zjxDnG56q literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/core.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eddebfaaf7e78c6db7b88265dbb6fcd1bd3dfb34 GIT binary patch literal 135717 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/decorators.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/decorators.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d19b95b946459dc5fa889234c5ec0b0d608651b5 GIT binary patch literal 24753 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 BkJ` zhH@-gDx9s`P{l4H1KV2J2doqeth7!M2PhD4QDD;_MHeUvkYN^5rVgNP(_;5mJo4YygU+KjR4kNMoOP=HI za1tl+QErsS(-yT&+D7d>(dsj5t?tmK#=Ro@au8*JPePV(L2q#C*Lo?UNkw24t`L9LUUENU~O z`a!Lin=NV!qc(urD7RSDRz__CwK=bB8>6;>+L}k*#;9$eZp))?XVmSW?#LU%4n}PU zRg~MU-b6;-32H|kb>|Ep==>FZ(nx^UDz3430-)3C*db=N~09T-$qXjUb?8tih3y& zk(7vf>HJK1JfuvXSK#OK+OkurHY!MDHauKNUMFUU!@iF8YitRs~ zxZnD>7e4MfvF59PD>Ql5*r_F^*4xEUI*0PC-@lZl!CB$$jCXR!L zqOyosRLA45i-|Z&$l^4%P@h8Iu2oFRs)`+;RO4+VZ1Dx&h<_Llok!x&`8!+!Pd&`r zX1Q;p{;ai&c`jkjrNt|=T#)LsFw5hOb^r@AoKlNKz@a(R=_&BDD;SK#B8gy7sQ_K` z&}emmq3oc7c1=*_=oov^+`(Wt8dB9@P^I=o@h00W%1*o_n+oTr&uq9Ind&Y?*qRSr zRr3`YSMy@i$F7}QPHx{xKHGaLC49@b*0dufeA}zEp zsu0{BwgYtj@e$*Y&I|@MPcS$cm!_kX_6CEmO^2dJ4whGnhe3AB*TG}qI5aZ}9>y^G zNA=)U;}e?e925VcsAhZaoMt}}n^8!WX;lWxh2>~87{tydPGURz8J+jGQ+pJV_)=d* z^y^#PC&EdH=i0iP&us_}NBfd}gTrH4_?#Xa)x2Zdl6{lIW5bDP(a+M4oGyoFvG#83 z+pS9{el+yX&~oj24J!@rJfCSfu)!hk!O$1<(5HdA4C7}7a}#a;7^IRCy^>_MB)jJ#31YTA zLp_i;5bS_AvJwkLizU1oxdN&xh9JsOM+DM}D}AE)@_0lQ6Ejm0Xy)jQM??r+jw=b2 zjLnE+(+Z@&qHBdn>`I@9l^A4NT{QS%kZB0kph+UNAw|@wXlSM{zeYH5eNc=W8zwr# zDu&|>t?7y=9D=5ikjALYAu`qwUynqitSK6z86Z}o_~e3iLeq&jz@h#@l&QuiWf9nA z8brb=td(Dp-Wt)hgB`KnY5ugho_E)Y3WgBvM*MSck%zJv=D|1YPcsPE;sc=R+D7CNWh!)VUj0Mt~k7LqcpwLgqP70C0e~lIve4Q7ZR2Zkt~fdL0hCKlo{+%R_goOnYQEOUEA zC|_}0j!yL{w8&7sLwIOTJzwKJ%6_~nbQ)l)JmA%p_emnKqU=ygEd=#C%0bGa)0yTq z`oqa4F|O6-6=G^tRSr;5h6CJmv}NL!sZ5gpy6Izd2ho zn67#DGk<-$;mNFjaMgbz<3F+1yzQ>*ZP#k^zD)DJ`_c#F?~kwcpU?E4Pk;TTO#g)q zJ6C^_-{frd)u|z9=BBoVZ!8{Kcq%mnNb=Ue{6M<0eXYLv&e_{%?~L3YNu7S^tyvhN z*VX#2Onq0jes9_zSgul{M1UcWY)*%3qlN*IM}pmPjwd8S z&*h!(b+2^aeTqpeO@aHV!k*EGkKnU^(gy5k|Md~n&pA}5mvPpQj7=*Yv`X_mD zv=j)6Oq7r>l7qnzXPMjzmg_2=D+?^wE!oCA48nK-VJdJm6>w;+q=PC09d3Y*D$RQ` zBw1#aP!+V})I*NqHSv%Hfs8mD^7~rR`PrL?u3K|GWk}M4liii3R6yPFOQAb6& zHsY7b-clarFd&8#IP03kK`vaD#i%@%pxNwYC-cX@kO3z8HjI^yy(LGjM z58m`y)iI?GwTP)T2m4%wSe6;9bdYJ8K0qcg1~%e0NdXmsOos_FXKf}P;JI0#qCA)> z;En3DU>ZtpaIxZv(%Dy%q88+l|yoC*?P*m+e1Z=of&AF=$ z1Ibe7$F8omhF0K1&sr-XK_8QO1;!EjeD=xD0CJTxj=WI?fP#X>VUCaeUTNs^MptQi zDLXAnmO$M137>f|2Ov}Z_ie#W5n*pR7ImVyMD-X0pCRMgY0xmsGn?$Q7G{dAf6Bhao zw{VfZrO4D}S~{3vmhhK}Y{(XpY%ADHx-1SF2gw^Kpnek(Lpg69pFf_i>{@Htez*PY z_W9wps@k_k=SS03okYS}f3@XMrsdH6!ygR1Kag!XIzP;y&Hk+az^ea9#((5P;UBzz z=S};MWc@Fuy)S;|t4Y@$&HA2R^$lfwLl2wwF1Kcz4nL578vRKWIH%?`;hY-J24^!Y zCM))lk&zWoNz73SZZKm{Nsw_KAEi)4_(F{#Vj#l@kg=ER>Rt=%TkGn6ROxo?Uazg+ zaNr57RqdniU36!vIyNeZ_!sag!l?ELQcvKVcC}k{@b=!wfI@f|ECF@EiBq^C| zv(^W{j8F=x4PkdU6@ zNbFkts;)+1c?c_!sYF@uaJUqB2ojztR>zT;1fxbmhP?(Bd4_o6V=T=$nc=2#I`C!G zFz(SveG&4BLA~NDs4c6$-YVg%at%@OD^TPyQ;kCbe}iyP( zE!P;z>E|mHq8Y}!Imw`u)~5>7Se7<5@AYUpbj_MC)G4j286=7{tJBo1*Ll^3i(s5* zp;v`_q>T}vWubd>S{A2H+lWF3v4A~KwZ1}xit<{O@^#fpW=5u33#=|J#T(Mnuirs= zm9#bK*P5Ju{qFXqlgswyi}!~=b{#LPU@c6s01^CuP_TzfE7Jd01#5$ihtH|ToXVTy zXL-ee72#oNu*G=E21-e5{hV#qcC(|*SQ|^zODSu#!<91bmbJJXE7Nuj7OW^t_=^a5 zEnWMb2|k2bL8+RxEACmlggr^Kkc6~!_BR_Adr@lgjbQfb(2{IQTr0%}=_OI;!DhO%4 zWqWG)vxcsvWVYc@%JWI!iG|k|TNk~VhTRY9Ql9mOmOH`Q!IWnWm*17!mv;TA`OYq8ANyH%+J7wTznJ!3T=zHKIePnO+S|^S2ge!; zfy$Bq{7H1AoBB#zOqMqF{XSKpD21Q;JwyzJyMe-6xm|nLb_aAIPFS1}^m=XGoz~l} zi>Ge4|E`!k52Z6~UQH<7$58q%M<3m3;<51p?{J8V{x5LZDe91&MjOV@3g+>1^RGcF z4cXyT@+Edc!`A00V+nMW(t>)O7W63nFZM;tg6L+Kpe|-X^b~+_ujUch zjuoSC813ZADKf7Brds|eCJ<--DpDLM*u>trqE^2gUlZ&a(JFPUnJ3b#bc0wV8c9TC zHD|N=5);iVCV_w?U`JcdVIhx)Nrn`Kd>+R2izO50$+!bm0pMw!<^ekk{9c%;$1)ZH zgo4u>N8-$UWlRa!++c8J96dt^Mn938&1EX$Kb6$VyI1|YSvW*8<8wWCt0}rmI8wawD!>Kc$SuQlXg{ZA7C4B5^ zUfbTC5`OM#eOw}wgk%!=zmX^_k-eoQ@&(A%QdXaw+$}9jO<8O{^8u=4lk5qT0n0e_ znDxwyu?d0#MFA_!=Uwj+^aMyR4(zJUMptc+@6M5=tyfI84dI|Q6Q9OCJ4~!Ma@%)i z?s&3u?|H+%Yitaa6aXU`JA5tx|G>%|X@+eG*Sh8nta%SU^!gTr)tZh>O-I(- zxmh9jJzu!E%G&v^#o&W;sjjT&g$>v+YG5frtG%~-7j`VZw$!xbPW!sku5Mk*UPS+8 z)C^NDmafrU7hoEY;e@C&6@6Z5T|;_Wq3ECRV;{(LjR0L!N4n-~PeR>1s`NT~)*G5P z9C!lz)cGxaQ$Z9L*W7X^c{{nZlYrRrg?IL6nhtHaDa%t}9-?*(%MYctc^o~u<)=sg zKpIFGKP#Bm+nX9}bpKPhpFpZjO+_P+{A6MwQv6Id-m-qH^Z12NvCSq=vFO)6B##Tn zjr$NX2(c>>Yv@tKJ7y$L7?U*3b4Ib01;~_U0`V{sMb-@50WkMU*f8?$2}qS#qQ$%! z$Twe*5&#q=mM$K{F3?ocJT&9^s-UTGWi4g!8>+Ak5tIR3B#SNtNZkM2)vWKwT9gX7 zOX9jhhSS-sq)nBChC8!dj@*-=M#rN7<_;5 zK_v6USw>iQSAF3?!ABe-eRR}l0k;^(a&D7O_k|w6Gd6gd)?h|X7}i0y+mqQGsKM?s zx7=6X>}HMMeY>;!fP%elwoRk?D!aWO7E0O!BP&9w6po7PDiZ2 zk5K*y6x02L(hB=3#^Kac5rfxRlV$O?mzI;9D8So>Giv=pFzeqNgdiXi@5!(V%wwO_K*5xvv(N@c!`_*m46n_pKX+)0Gwpai%v19`6gc@1E*$V z-u2UQ&nb3kOzTXGtS|fxbCq{0MOR>Kk_Zc7)^ce2CJ6emc@I)54Lcv_H0S265aiU; z>>WU9IFi#X)UmAZ_^R*OjPKdChL+Wa-7vo_C*GS~nWbx}GsV|X%yC!w2K9Z+?DiQQ zUd<7aA~*FwY5^$Y6QTE!;B@R<@^5f>ET4F9cxCv$x^j-aewg^2s2eqQ{dNcsoqwsB zFn(4rSEZcPbDSVY(d5%7^1M!UH`6Gox}rZZFda~J-vylPn44+eh>}Ey3SIr>iIG31 zSBhHcyJ-90f)n`}y#&z<25Pd$W*2e_#WVYZ3^>o4f0BVe$8d}~XB+{SCY*+AbMjjl zebGqs?^*D-5riJ#YJiKO0`~)QjD}NcVx0MxG64xcm&CLR^dP~*f>8`dS)%B`Ag>6W zZmmZ2yAF6s58x9tfjL~0&?)@;3fj?j{5Hvf7$+i9??~yvQ18m0;?=x^eG};d3(igu zl2!EO7HjXJDJGEt&fd`hhOK7P40|bchjRgKt0I>x`hyBJ8c*O4Dl|KM*mSv5w1|H~ z^(fjwJy6f2p9ukbx!U%d&pi@&N9W>&4Y+f6F4u3-LtkL36X?*KFt}nPDGYtnXX~6u zB0#HvPx>T0@R;Ks{=O_4zYOnY{ZBz0(}@VuE~>#qVb#m8oIf2rb@ueB=bsxnL$j;M ziifi4FsFNF3{tC(i!r$MC<&r696~l>&29bZ40Bgko}ujX6p_+mAfMq7UHK6kY2KHn zV~NP5u5s8#W)o4g%{A9i-T(fW@*UK|EOF|;BigX@Jpa#J-KU)RDYxz4xLu!e-Jfzz zpK=}RcHzzA-#q@Qu$}#H-*7tl#A?F|T^sLNcx8*jW9#THq<3s_cx;XEd+;*2#o@8_ zGJlfi#f8}|j-Fe?wsyXU^6=Oi;;Z>R3!_^c9$Otw-nEe2;_%q2t40IWME7iU@cdam W^#Ya`&n=gS?@S&2oWp~y_5T1i!jqQ( literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/formatting.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/formatting.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4bbad414411ef2ca329fa056d3b1854bbf9050ed GIT binary patch literal 14077 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 M_MLyIy$;TQ05He**8l(j literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/parser.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/parser.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1e0740d74f3e47cc97632c6f328c756596ed71a5 GIT binary patch literal 21507 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

+ FastAPI +

+

+ FastAPI framework, high performance, easy to learn, fast to code, ready for production +

+

+ + Test + + + Coverage + + + Package version + + + Supported Python versions + +

+ +--- + +**Documentation**: https://fastapi.tiangolo.com + +**Source Code**: https://github.com/fastapi/fastapi + +--- + +FastAPI is a modern, fast (high-performance), web framework for building APIs with Python based on standard Python type hints. + +The key features are: + +* **Fast**: Very high performance, on par with **NodeJS** and **Go** (thanks to Starlette and Pydantic). [One of the fastest Python frameworks available](#performance). +* **Fast to code**: Increase the speed to develop features by about 200% to 300%. * +* **Fewer bugs**: Reduce about 40% of human (developer) induced errors. * +* **Intuitive**: Great editor support. Completion everywhere. Less time debugging. +* **Easy**: Designed to be easy to use and learn. Less time reading docs. +* **Short**: Minimize code duplication. Multiple features from each parameter declaration. Fewer bugs. +* **Robust**: Get production-ready code. With automatic interactive documentation. +* **Standards-based**: Based on (and fully compatible with) the open standards for APIs: OpenAPI (previously known as Swagger) and JSON Schema. + +* estimation based on tests on an internal development team, building production applications. + +## Sponsors + + + + + + + + + + + + + + + + + + + + + + + + +Other sponsors + +## Opinions + +"_[...] I'm using **FastAPI** a ton these days. [...] I'm actually planning to use it for all of my team's **ML services at Microsoft**. Some of them are getting integrated into the core **Windows** product and some **Office** products._" + +
Kabir Khan - Microsoft (ref)
+ +--- + +"_We adopted the **FastAPI** library to spawn a **REST** server that can be queried to obtain **predictions**. [for Ludwig]_" + +
Piero Molino, Yaroslav Dudin, and Sai Sumanth Miryala - Uber (ref)
+ +--- + +"_**Netflix** is pleased to announce the open-source release of our **crisis management** orchestration framework: **Dispatch**! [built with **FastAPI**]_" + +
Kevin Glisson, Marc Vilanova, Forest Monsen - Netflix (ref)
+ +--- + +"_I’m over the moon excited about **FastAPI**. It’s so fun!_" + +
Brian Okken - Python Bytes podcast host (ref)
+ +--- + +"_Honestly, what you've built looks super solid and polished. In many ways, it's what I wanted **Hug** to be - it's really inspiring to see someone build that._" + +
Timothy Crosley - Hug creator (ref)
+ +--- + +"_If you're looking to learn one **modern framework** for building REST APIs, check out **FastAPI** [...] It's fast, easy to use and easy to learn [...]_" + +"_We've switched over to **FastAPI** for our **APIs** [...] I think you'll like it [...]_" + +
Ines Montani - Matthew Honnibal - Explosion AI founders - spaCy creators (ref) - (ref)
+ +--- + +"_If anyone is looking to build a production Python API, I would highly recommend **FastAPI**. It is **beautifully designed**, **simple to use** and **highly scalable**, it has become a **key component** in our API first development strategy and is driving many automations and services such as our Virtual TAC Engineer._" + +
Deon Pillsbury - Cisco (ref)
+ +--- + +## **Typer**, the FastAPI of CLIs + + + +If you are building a CLI app to be used in the terminal instead of a web API, check out **Typer**. + +**Typer** is FastAPI's little sibling. And it's intended to be the **FastAPI of CLIs**. ⌨️ 🚀 + +## Requirements + +FastAPI stands on the shoulders of giants: + +* Starlette for the web parts. +* Pydantic for the data parts. + +## Installation + +Create and activate a virtual environment and then install FastAPI: + +
+ +```console +$ pip install "fastapi[standard]" + +---> 100% +``` + +
+ +**Note**: Make sure you put `"fastapi[standard]"` in quotes to ensure it works in all terminals. + +## Example + +### Create it + +* Create a file `main.py` with: + +```Python +from typing import Union + +from fastapi import FastAPI + +app = FastAPI() + + +@app.get("/") +def read_root(): + return {"Hello": "World"} + + +@app.get("/items/{item_id}") +def read_item(item_id: int, q: Union[str, None] = None): + return {"item_id": item_id, "q": q} +``` + +
+Or use async def... + +If your code uses `async` / `await`, use `async def`: + +```Python hl_lines="9 14" +from typing import Union + +from fastapi import FastAPI + +app = FastAPI() + + +@app.get("/") +async def read_root(): + return {"Hello": "World"} + + +@app.get("/items/{item_id}") +async def read_item(item_id: int, q: Union[str, None] = None): + return {"item_id": item_id, "q": q} +``` + +**Note**: + +If you don't know, check the _"In a hurry?"_ section about `async` and `await` in the docs. + +
+ +### Run it + +Run the server with: + +
+ +```console +$ fastapi dev main.py + + ╭────────── FastAPI CLI - Development mode ───────────╮ + │ │ + │ Serving at: http://127.0.0.1:8000 │ + │ │ + │ API docs: http://127.0.0.1:8000/docs │ + │ │ + │ Running in development mode, for production use: │ + │ │ + │ fastapi run │ + │ │ + ╰─────────────────────────────────────────────────────╯ + +INFO: Will watch for changes in these directories: ['/home/user/code/awesomeapp'] +INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) +INFO: Started reloader process [2248755] using WatchFiles +INFO: Started server process [2248757] +INFO: Waiting for application startup. +INFO: Application startup complete. +``` + +
+ +
+About the command fastapi dev main.py... + +The command `fastapi dev` reads your `main.py` file, detects the **FastAPI** app in it, and starts a server using Uvicorn. + +By default, `fastapi dev` will start with auto-reload enabled for local development. + +You can read more about it in the FastAPI CLI docs. + +
+ +### Check it + +Open your browser at http://127.0.0.1:8000/items/5?q=somequery. + +You will see the JSON response as: + +```JSON +{"item_id": 5, "q": "somequery"} +``` + +You already created an API that: + +* Receives HTTP requests in the _paths_ `/` and `/items/{item_id}`. +* Both _paths_ take `GET` operations (also known as HTTP _methods_). +* The _path_ `/items/{item_id}` has a _path parameter_ `item_id` that should be an `int`. +* The _path_ `/items/{item_id}` has an optional `str` _query parameter_ `q`. + +### Interactive API docs + +Now go to http://127.0.0.1:8000/docs. + +You will see the automatic interactive API documentation (provided by Swagger UI): + +![Swagger UI](https://fastapi.tiangolo.com/img/index/index-01-swagger-ui-simple.png) + +### Alternative API docs + +And now, go to http://127.0.0.1:8000/redoc. + +You will see the alternative automatic documentation (provided by ReDoc): + +![ReDoc](https://fastapi.tiangolo.com/img/index/index-02-redoc-simple.png) + +## Example upgrade + +Now modify the file `main.py` to receive a body from a `PUT` request. + +Declare the body using standard Python types, thanks to Pydantic. + +```Python hl_lines="4 9-12 25-27" +from typing import Union + +from fastapi import FastAPI +from pydantic import BaseModel + +app = FastAPI() + + +class Item(BaseModel): + name: str + price: float + is_offer: Union[bool, None] = None + + +@app.get("/") +def read_root(): + return {"Hello": "World"} + + +@app.get("/items/{item_id}") +def read_item(item_id: int, q: Union[str, None] = None): + return {"item_id": item_id, "q": q} + + +@app.put("/items/{item_id}") +def update_item(item_id: int, item: Item): + return {"item_name": item.name, "item_id": item_id} +``` + +The `fastapi dev` server should reload automatically. + +### Interactive API docs upgrade + +Now go to http://127.0.0.1:8000/docs. + +* The interactive API documentation will be automatically updated, including the new body: + +![Swagger UI](https://fastapi.tiangolo.com/img/index/index-03-swagger-02.png) + +* Click on the button "Try it out", it allows you to fill the parameters and directly interact with the API: + +![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-04-swagger-03.png) + +* Then click on the "Execute" button, the user interface will communicate with your API, send the parameters, get the results and show them on the screen: + +![Swagger UI interaction](https://fastapi.tiangolo.com/img/index/index-05-swagger-04.png) + +### Alternative API docs upgrade + +And now, go to http://127.0.0.1:8000/redoc. + +* The alternative documentation will also reflect the new query parameter and body: + +![ReDoc](https://fastapi.tiangolo.com/img/index/index-06-redoc-02.png) + +### Recap + +In summary, you declare **once** the types of parameters, body, etc. as function parameters. + +You do that with standard modern Python types. + +You don't have to learn a new syntax, the methods or classes of a specific library, etc. + +Just standard **Python**. + +For example, for an `int`: + +```Python +item_id: int +``` + +or for a more complex `Item` model: + +```Python +item: Item +``` + +...and with that single declaration you get: + +* Editor support, including: + * Completion. + * Type checks. +* Validation of data: + * Automatic and clear errors when the data is invalid. + * Validation even for deeply nested JSON objects. +* Conversion of input data: coming from the network to Python data and types. Reading from: + * JSON. + * Path parameters. + * Query parameters. + * Cookies. + * Headers. + * Forms. + * Files. +* Conversion of output data: converting from Python data and types to network data (as JSON): + * Convert Python types (`str`, `int`, `float`, `bool`, `list`, etc). + * `datetime` objects. + * `UUID` objects. + * Database models. + * ...and many more. +* Automatic interactive API documentation, including 2 alternative user interfaces: + * Swagger UI. + * ReDoc. + +--- + +Coming back to the previous code example, **FastAPI** will: + +* Validate that there is an `item_id` in the path for `GET` and `PUT` requests. +* Validate that the `item_id` is of type `int` for `GET` and `PUT` requests. + * If it is not, the client will see a useful, clear error. +* Check if there is an optional query parameter named `q` (as in `http://127.0.0.1:8000/items/foo?q=somequery`) for `GET` requests. + * As the `q` parameter is declared with `= None`, it is optional. + * Without the `None` it would be required (as is the body in the case with `PUT`). +* For `PUT` requests to `/items/{item_id}`, read the body as JSON: + * Check that it has a required attribute `name` that should be a `str`. + * Check that it has a required attribute `price` that has to be a `float`. + * Check that it has an optional attribute `is_offer`, that should be a `bool`, if present. + * All this would also work for deeply nested JSON objects. +* Convert from and to JSON automatically. +* Document everything with OpenAPI, that can be used by: + * Interactive documentation systems. + * Automatic client code generation systems, for many languages. +* Provide 2 interactive documentation web interfaces directly. + +--- + +We just scratched the surface, but you already get the idea of how it all works. + +Try changing the line with: + +```Python + return {"item_name": item.name, "item_id": item_id} +``` + +...from: + +```Python + ... "item_name": item.name ... +``` + +...to: + +```Python + ... "item_price": item.price ... +``` + +...and see how your editor will auto-complete the attributes and know their types: + +![editor support](https://fastapi.tiangolo.com/img/vscode-completion.png) + +For a more complete example including more features, see the Tutorial - User Guide. + +**Spoiler alert**: the tutorial - user guide includes: + +* Declaration of **parameters** from other different places as: **headers**, **cookies**, **form fields** and **files**. +* How to set **validation constraints** as `maximum_length` or `regex`. +* A very powerful and easy to use **Dependency Injection** system. +* Security and authentication, including support for **OAuth2** with **JWT tokens** and **HTTP Basic** auth. +* More advanced (but equally easy) techniques for declaring **deeply nested JSON models** (thanks to Pydantic). +* **GraphQL** integration with Strawberry and other libraries. +* Many extra features (thanks to Starlette) as: + * **WebSockets** + * extremely easy tests based on HTTPX and `pytest` + * **CORS** + * **Cookie Sessions** + * ...and more. + +## Performance + +Independent TechEmpower benchmarks show **FastAPI** applications running under Uvicorn as one of the fastest Python frameworks available, only below Starlette and Uvicorn themselves (used internally by FastAPI). (*) + +To understand more about it, see the section Benchmarks. + +## Dependencies + +FastAPI depends on Pydantic and Starlette. + +### `standard` Dependencies + +When you install FastAPI with `pip install "fastapi[standard]"` it comes with the `standard` group of optional dependencies: + +Used by Pydantic: + +* email-validator - for email validation. + +Used by Starlette: + +* httpx - Required if you want to use the `TestClient`. +* jinja2 - Required if you want to use the default template configuration. +* python-multipart - Required if you want to support form "parsing", with `request.form()`. + +Used by FastAPI / Starlette: + +* uvicorn - for the server that loads and serves your application. This includes `uvicorn[standard]`, which includes some dependencies (e.g. `uvloop`) needed for high performance serving. +* `fastapi-cli` - to provide the `fastapi` command. + +### Without `standard` Dependencies + +If you don't want to include the `standard` optional dependencies, you can install with `pip install fastapi` instead of `pip install "fastapi[standard]"`. + +### Additional Optional Dependencies + +There are some additional dependencies you might want to install. + +Additional optional Pydantic dependencies: + +* pydantic-settings - for settings management. +* pydantic-extra-types - for extra types to be used with Pydantic. + +Additional optional FastAPI dependencies: + +* orjson - Required if you want to use `ORJSONResponse`. +* ujson - Required if you want to use `UJSONResponse`. + +## License + +This project is licensed under the terms of the MIT license. diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/RECORD b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/RECORD new file mode 100644 index 0000000..aecdeca --- /dev/null +++ b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/RECORD @@ -0,0 +1,97 @@ +../../Scripts/fastapi.exe,sha256=CPNt_QmAFOIzqA_udnFeIt8iKFJVZuFyTb3vE-Rz2CM,108435 +fastapi-0.115.11.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +fastapi-0.115.11.dist-info/METADATA,sha256=PH2KnmUbLuqslWRRtwHFmddi9raK7rQ7yoOZ5oul-Qk,27671 +fastapi-0.115.11.dist-info/RECORD,, +fastapi-0.115.11.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +fastapi-0.115.11.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90 +fastapi-0.115.11.dist-info/entry_points.txt,sha256=GCf-WbIZxyGT4MUmrPGj1cOHYZoGsNPHAvNkT6hnGeA,61 +fastapi-0.115.11.dist-info/licenses/LICENSE,sha256=Tsif_IFIW5f-xYSy1KlhAy7v_oNEU4lP2cEnSQbMdE4,1086 +fastapi/__init__.py,sha256=jT25pkKhWircnSeQIXu4yR6y5dx6BD1vj2w8BFLGAVE,1082 +fastapi/__main__.py,sha256=bKePXLdO4SsVSM6r9SVoLickJDcR2c0cTOxZRKq26YQ,37 +fastapi/__pycache__/__init__.cpython-312.pyc,, +fastapi/__pycache__/__main__.cpython-312.pyc,, +fastapi/__pycache__/_compat.cpython-312.pyc,, +fastapi/__pycache__/applications.cpython-312.pyc,, +fastapi/__pycache__/background.cpython-312.pyc,, +fastapi/__pycache__/cli.cpython-312.pyc,, +fastapi/__pycache__/concurrency.cpython-312.pyc,, +fastapi/__pycache__/datastructures.cpython-312.pyc,, +fastapi/__pycache__/encoders.cpython-312.pyc,, +fastapi/__pycache__/exception_handlers.cpython-312.pyc,, +fastapi/__pycache__/exceptions.cpython-312.pyc,, +fastapi/__pycache__/logger.cpython-312.pyc,, +fastapi/__pycache__/param_functions.cpython-312.pyc,, +fastapi/__pycache__/params.cpython-312.pyc,, +fastapi/__pycache__/requests.cpython-312.pyc,, +fastapi/__pycache__/responses.cpython-312.pyc,, +fastapi/__pycache__/routing.cpython-312.pyc,, +fastapi/__pycache__/staticfiles.cpython-312.pyc,, +fastapi/__pycache__/templating.cpython-312.pyc,, +fastapi/__pycache__/testclient.cpython-312.pyc,, +fastapi/__pycache__/types.cpython-312.pyc,, +fastapi/__pycache__/utils.cpython-312.pyc,, +fastapi/__pycache__/websockets.cpython-312.pyc,, +fastapi/_compat.py,sha256=Rg7kA7uue4Z6yr8T7hf8b7G6PeC_06mK004Nnykijfk,23953 +fastapi/applications.py,sha256=Ix-o9pQAWhEDf9J0Q1hZ0nBB1uP72c-Y3oiYzvrwqiM,176316 +fastapi/background.py,sha256=rouLirxUANrcYC824MSMypXL_Qb2HYg2YZqaiEqbEKI,1768 +fastapi/cli.py,sha256=OYhZb0NR_deuT5ofyPF2NoNBzZDNOP8Salef2nk-HqA,418 +fastapi/concurrency.py,sha256=MirfowoSpkMQZ8j_g0ZxaQKpV6eB3G-dB5TgcXCrgEA,1424 +fastapi/datastructures.py,sha256=b2PEz77XGq-u3Ur1Inwk0AGjOsQZO49yF9C7IPJ15cY,5766 +fastapi/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +fastapi/dependencies/__pycache__/__init__.cpython-312.pyc,, +fastapi/dependencies/__pycache__/models.cpython-312.pyc,, +fastapi/dependencies/__pycache__/utils.cpython-312.pyc,, +fastapi/dependencies/models.py,sha256=Pjl6vx-4nZ5Tta9kJa3-RfQKkXtCpS09-FhMgs9eWNs,1507 +fastapi/dependencies/utils.py,sha256=UqN1H0k_4PCnP-nRYNpup1fdIuzEx1F5ZVO6WuVRx4E,35579 +fastapi/encoders.py,sha256=LvwYmFeOz4tVwvgBoC5rvZnbr7hZr73KGrU8O7zSptU,11068 +fastapi/exception_handlers.py,sha256=MBrIOA-ugjJDivIi4rSsUJBdTsjuzN76q4yh0q1COKw,1332 +fastapi/exceptions.py,sha256=taNixuFEXb67lI1bnX1ubq8y8TseJ4yoPlWjyP0fTzk,4969 +fastapi/logger.py,sha256=I9NNi3ov8AcqbsbC9wl1X-hdItKgYt2XTrx1f99Zpl4,54 +fastapi/middleware/__init__.py,sha256=oQDxiFVcc1fYJUOIFvphnK7pTT5kktmfL32QXpBFvvo,58 +fastapi/middleware/__pycache__/__init__.cpython-312.pyc,, +fastapi/middleware/__pycache__/cors.cpython-312.pyc,, +fastapi/middleware/__pycache__/gzip.cpython-312.pyc,, +fastapi/middleware/__pycache__/httpsredirect.cpython-312.pyc,, +fastapi/middleware/__pycache__/trustedhost.cpython-312.pyc,, +fastapi/middleware/__pycache__/wsgi.cpython-312.pyc,, +fastapi/middleware/cors.py,sha256=ynwjWQZoc_vbhzZ3_ZXceoaSrslHFHPdoM52rXr0WUU,79 +fastapi/middleware/gzip.py,sha256=xM5PcsH8QlAimZw4VDvcmTnqQamslThsfe3CVN2voa0,79 +fastapi/middleware/httpsredirect.py,sha256=rL8eXMnmLijwVkH7_400zHri1AekfeBd6D6qs8ix950,115 +fastapi/middleware/trustedhost.py,sha256=eE5XGRxGa7c5zPnMJDGp3BxaL25k5iVQlhnv-Pk0Pss,109 +fastapi/middleware/wsgi.py,sha256=Z3Ue-7wni4lUZMvH3G9ek__acgYdJstbnpZX_HQAboY,79 +fastapi/openapi/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +fastapi/openapi/__pycache__/__init__.cpython-312.pyc,, +fastapi/openapi/__pycache__/constants.cpython-312.pyc,, +fastapi/openapi/__pycache__/docs.cpython-312.pyc,, +fastapi/openapi/__pycache__/models.cpython-312.pyc,, +fastapi/openapi/__pycache__/utils.cpython-312.pyc,, +fastapi/openapi/constants.py,sha256=adGzmis1L1HJRTE3kJ5fmHS_Noq6tIY6pWv_SFzoFDU,153 +fastapi/openapi/docs.py,sha256=XcQq-ZbQdC5sI0gIGu5MoHK1q-OFaqws7-ORTo6sjY4,10348 +fastapi/openapi/models.py,sha256=PqkxQiqcEgjKuhfUIWPZPQcyTcubtUCB3vcObLsB7VE,15397 +fastapi/openapi/utils.py,sha256=vpbAzWpuNaJL_ocBxt4jp0GUUwrDKNB1anyoAx69fhA,23177 +fastapi/param_functions.py,sha256=JHNPLIYvoAwdnZZavIVsxOat8x23fX_Kl33reh7HKl8,64019 +fastapi/params.py,sha256=g450axUBQgQJODdtM7WBxZbQj9Z64inFvadrgHikBbU,28237 +fastapi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +fastapi/requests.py,sha256=zayepKFcienBllv3snmWI20Gk0oHNVLU4DDhqXBb4LU,142 +fastapi/responses.py,sha256=QNQQlwpKhQoIPZTTWkpc9d_QGeGZ_aVQPaDV3nQ8m7c,1761 +fastapi/routing.py,sha256=WK06IwZeyRwxkdB4uHZ7JXinxtVOxM8Ke0tqHaDOvYA,176208 +fastapi/security/__init__.py,sha256=bO8pNmxqVRXUjfl2mOKiVZLn0FpBQ61VUYVjmppnbJw,881 +fastapi/security/__pycache__/__init__.cpython-312.pyc,, +fastapi/security/__pycache__/api_key.cpython-312.pyc,, +fastapi/security/__pycache__/base.cpython-312.pyc,, +fastapi/security/__pycache__/http.cpython-312.pyc,, +fastapi/security/__pycache__/oauth2.cpython-312.pyc,, +fastapi/security/__pycache__/open_id_connect_url.cpython-312.pyc,, +fastapi/security/__pycache__/utils.cpython-312.pyc,, +fastapi/security/api_key.py,sha256=cBI5Z4zWVjL1uJrsjTeLy7MafHPAO2HQPzTrpyoIYWA,9094 +fastapi/security/base.py,sha256=dl4pvbC-RxjfbWgPtCWd8MVU-7CB2SZ22rJDXVCXO6c,141 +fastapi/security/http.py,sha256=rWR2x-5CUsjWmRucYthwRig6MG1o-boyrr4Xo-PuuxU,13606 +fastapi/security/oauth2.py,sha256=xCo5j1qpze6CvEuJHIneOI0v2fodGVMpHHVnHpiLfoM,21589 +fastapi/security/open_id_connect_url.py,sha256=8vizZ2tGqEp1ur8SwtVgyHJhGAJ5AqahgcvSpaIioDI,2722 +fastapi/security/utils.py,sha256=bd8T0YM7UQD5ATKucr1bNtAvz_Y3__dVNAv5UebiPvc,293 +fastapi/staticfiles.py,sha256=iirGIt3sdY2QZXd36ijs3Cj-T0FuGFda3cd90kM9Ikw,69 +fastapi/templating.py,sha256=4zsuTWgcjcEainMJFAlW6-gnslm6AgOS1SiiDWfmQxk,76 +fastapi/testclient.py,sha256=nBvaAmX66YldReJNZXPOk1sfuo2Q6hs8bOvIaCep6LQ,66 +fastapi/types.py,sha256=nFb36sK3DSoqoyo7Miwy3meKK5UdFBgkAgLSzQlUVyI,383 +fastapi/utils.py,sha256=y8Bj5ttMaI9tS4D60OUgXqKnktBr99NdYUnHHV9LgoY,7948 +fastapi/websockets.py,sha256=419uncYObEKZG0YcrXscfQQYLSWoE10jqxVMetGdR98,222 diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/REQUESTED b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/REQUESTED new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/WHEEL b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/WHEEL new file mode 100644 index 0000000..64b991e --- /dev/null +++ b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: pdm-backend (2.4.3) +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/entry_points.txt b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/entry_points.txt new file mode 100644 index 0000000..b81849e --- /dev/null +++ b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/entry_points.txt @@ -0,0 +1,5 @@ +[console_scripts] +fastapi = fastapi.cli:main + +[gui_scripts] + diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/licenses/LICENSE b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/licenses/LICENSE new file mode 100644 index 0000000..3e92463 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/licenses/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2018 Sebastián Ramírez + +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/.venv/Lib/site-packages/fastapi/__init__.py b/.venv/Lib/site-packages/fastapi/__init__.py new file mode 100644 index 0000000..757b761 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/__init__.py @@ -0,0 +1,25 @@ +"""FastAPI framework, high performance, easy to learn, fast to code, ready for production""" + +__version__ = "0.115.11" + +from starlette import status as status + +from .applications import FastAPI as FastAPI +from .background import BackgroundTasks as BackgroundTasks +from .datastructures import UploadFile as UploadFile +from .exceptions import HTTPException as HTTPException +from .exceptions import WebSocketException as WebSocketException +from .param_functions import Body as Body +from .param_functions import Cookie as Cookie +from .param_functions import Depends as Depends +from .param_functions import File as File +from .param_functions import Form as Form +from .param_functions import Header as Header +from .param_functions import Path as Path +from .param_functions import Query as Query +from .param_functions import Security as Security +from .requests import Request as Request +from .responses import Response as Response +from .routing import APIRouter as APIRouter +from .websockets import WebSocket as WebSocket +from .websockets import WebSocketDisconnect as WebSocketDisconnect diff --git a/.venv/Lib/site-packages/fastapi/__main__.py b/.venv/Lib/site-packages/fastapi/__main__.py new file mode 100644 index 0000000..fc36465 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/__main__.py @@ -0,0 +1,3 @@ +from fastapi.cli import main + +main() diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..dc85a8e66a0aeb90da1fff89feffc82c9d1d15e5 GIT binary patch literal 1121 zcmYk5TWb_C6vs2&%j|vI-QK*yzKY z&){eA6Sy!Uh!4IAzKIW>q_sG(|NWhleRqgnTo>zh~wMe*HoC zKq5j(xryARUCS-xSvqUEjXX!^EO(H5v}d`C+^2oZv&i#w-trvs0$s4&LtdndmiuBU zS*FXD=f#QSBt2<)L7YlX)60JGA4ny~7UmWRfv2Z*BnWxb%Q)7jx#`8=_7H!9ZW7K}QyE}OB zHsqNpjfvh%K71y_G1vcR%Ud#<;Ar)pl;hYebno+wr;({xKB`sT#-_}qhxpbU%*cT0 zef+OH%{iF$wP!rcA=ZZ79sWA!N}Kc!SD8$eDO^X#c4V$?f%@^=;7I>CxF4%frYR5g zlNE33206;w>BF+6q$swUBim`48r zjn089aP2Jq&mILeOhDaayBWh%4fgWX9*P3f?Tn1$f%bKvQdyr7LeD!kS#cm)&2rvFhyek literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/__main__.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b1e1b436f831e6bf2945256c29e68b388a69de2c GIT binary patch literal 267 zcmX@j%ge<81gZgd(^Y}=V-N=hn4pZ$azMs(h7^Vr#vF!R#wbQc1}277#??@1Mutiz zP3D&%o+jfhmfXb5JU>mQTij`h#U+UanR>}NnMKS%$(0PBL27>GI9tVp7N-^!$0TN^ z6lE621XLzxBo^fc6y;~7CYKb)6cp*Er{<*=C6?qD#pL9t7sn(4$@s*Ag81ChY)gX} zy|UE2vKXJtq?qE&l2qM-#N_P6^wi=QsEzvZ@gPUU$LkeT-r}&y%}*)KNwq8D09wun a#KpWo;sY}yBja5LnTHH4t!zbXKoJ0zm`Ixd literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/_compat.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/_compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6a58e80876220ce1290d07d688848933e4dfbc6d GIT binary patch literal 27895 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/applications.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/applications.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26f82777acc2aa33a3e2cdd01df0ecc480bead14 GIT binary patch literal 84135 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/background.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/background.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3bcadbb7a9cc2ea900acc159017af33114ff0329 GIT binary patch literal 2393 zcmcIm&5smC6tAA1Z*~|~76rsm8KO=TcE)(v)rlBZR6;^FtDuK*OmA&>^=z~KWmV1Y z4lD_YB*H<(gTW&q9yG+i#0%?5J27a~L~lbDBk|;`>YfiF8ZUNsUwysz>b+mp`_+71 zsgx0XPcMDn{WXu!PjWE)a%pF$4V@dvMz-c5Uu$cArk&B`IOFMlww+Ub-OKxhcEK;U zi+-tH(ohD`lAXP+C0^R)3_6AE+!bW!Y3{b3&Sv`sqxhQ~7@1gK2>NmHB=J15;!#73 ztFI7it;@n*V4ov=jT?GgS_pzr5JBx&e>Jq?(h_0BKO0di)|RZqYa)y3U}pW zwKW^HGq%>&?F`M*9L>{$lQ{tE5Ny%bhruRuc9!PPKbCr#Xl$@MKQl3rcI~`faEe!v zquIqPQ|(<>(Wcg(I*W`FlTeaVkaQWtw}7qC^Qa}D!vr(RqcGqUuM!T+G*B)%4Fnb;Sb~A)!l+SJ3vW_lV?SgRla;V1unT{I zR8y<(yiT}SSUQdE(Bjw$86G2!73A;MSA~dptJ!owl|*hsxFqO?Uf8fgzbSemWG?ZV z;~ZvH4oxEs;K&jD+9vTMk0t>vFE2-Zu^J|EJ1q2Z>KVI!6f!Xpf{Nf6PJ>MBNfhDZ z!>PJaPG)WD;0@*qYQpVs9oHff+&cA%>$NZ!>=^bb=cG%I*J?&fB`=R+!xgJIjA&4= zd11F9Hbo6ILmSjKY6b>~l?&5xJvz3MmR1-D3HovD)F$^-C|*=nmsV#Sk13dxD z!@3P(+sdl`D9Fc>Y$gEap-=H-#A&25b4Epv1^8ku1*X=*wZ(}elSvG(=tN=EE~#AM z@~Ae>I=#TUaO-cNO84jB{>vp*T2K$Nc+%35r78BX z@eXlq=JL)`-&!TiUt-~TAYtB#*ld>ulo8;v4$uJatbjD322H=W_TqD$#ySnwJ7?UL z4hM>vjexI#Nq8qEt_kvMM13|5J73s8CQ`*>qY8QkR{3EN4=$toN70^r*EY7Rhi_)@ zROfDrZ>n=&tZ!H6?iA;CKm{3Upw1Wt#8xh?lMuOcMy)G#NbM zh{1J1tRw|IIEWRb7(t|>iz_Kk7WF*SG&Hssl(@WgCzyQM)Ptpj^usL>53ZnlnS;6F z;Dvp;`5$&a@$J;i^*27#ufM%Lb?CdP>L8Pyp4rj!mE8lqP^sS2OV#oq2dabpXwUS= z>(|x?2ju7=+BM(#K-U}|1)iX!V3EHO6jWcLWOJE(Tzo0P`DKP-C{f|h rf*9zUrrkyO7j)(>n%_qAKV~aet@jr%YxncdYx8#=Z~Ts+RgV4wGd-^$ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/cli.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/cli.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f62b7d22fa21196a3b9aa1b31695a15fe4707b78 GIT binary patch literal 681 zcmaJ<&ubGw6n?WmnoXJ?U;-6SYolPm)*b}0h!+vGNC;97jVocYJKc`mAH&R~HAO*! zLJ#$7d-f*%Q@jXX%95Nsc?-sa^yEys;>`#1&3o_r_;_!2zf>wEP;tF82|po#@4EOK zR-VjmtK=Ap5I}$;h*8%-5Lkiv&g!C}(F9^%18%FH(KWWygqG1h z=x?U(KoD2%5O*63i5YeMG>&l++;mw)u;OT<`cdRA=Yr>|Oajb<7t8CVQjt;iKS`-& zW{w}xp58FC8K;TN%1;N0q%nEOdCJxLg_sC|Ln8E`?s@oN-Fqeo7apbor^4$D{Tk!)HtivM~}3kaW2YAJX)y0hr*Ki5iOa20N<6b9smFU literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/concurrency.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/concurrency.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4176f122b70d71d2859c7e6dcd4741e3405f4d5d GIT binary patch literal 1694 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 O9K4oZc!)11@c#wV-XQk? literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/encoders.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/encoders.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26fac5e6c4758b3e6a9a9ea581fa33d56b0193d2 GIT binary patch literal 10916 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 R3^e#2!{vFV(gI!c{|g;ougd@c literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/exception_handlers.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/exception_handlers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d49e028b811a16bf013da4b1aae4161796eb4c24 GIT binary patch literal 2095 zcmb7FO>7%Q6rSDnuATTVNzv<(u4nh+;xDvg>tc zCTUZGR3!)r35jx{9LtGDDe48JA`WoifW)OzbEsB{T8RtXEF1~wiTBoPCxr;XNPh3l zo7tH+-}~P4Ptj;IfpL6%d-k+S$j>;b56w5KcfhzwOkzqFv89|Op)Fgot>hFtkPCQo z#Zql8r+Ie33fiGu$g@?e$!^Xyd$wkU?MN=-*+DC6$8s?{o{M|)kkw+h=34ExTpP@r zXvA!$&1RU!XEZbNejs&@x^Fj-Y=ugb_KP&7>zNFFPep-B8_v zl_U6-e){A|{X%+tA~TZ8W{2MxOX;cfUAL#FYO&`yUjgDN>FOFu$h9^fe zX*bAfFLM=owcu)uibYl`$bK48L5j&5{Hi~Ic$-L&Rw04ujTOn1OtPWWX79yRA9eHz`CcVi_*WG<42VxUn*CmL;#*W zM-50V2k63klEK>GFjq6FFp5?}bAz*B3BefhnjJt9MuGRUb`S}L#n6tUz>hgz)!p6w zWNBn5e}Tgld825uBF~R67v>CRk27bU76i|iS???@QDz8-pJ(n(ZN^jg zL#eHB=fkGf8>em#eKK@EboBPf-OPIC`>7p8j%XDktJF#D7xcHPZnjj;z^gZEp8c2otiQV=UFjMbiAsQfE*ntS~t{S<2Weh;-3Flwl+koiW{fzuzm z2>xIE?nw3OT7%a7F5vR1d{g;ARiVO{$*bfe)x%UyLx}{iQDJj1pfx4}u3E4hpmr33 z@Bn3p!2&d&MF*C`Q)ng|kJSGYuFt^%NAQr-AUs?v8VR?5-1lMMR`mF0^6WkS-L-G7 zeY^4?IaX0f_;8iTVeNOM;cqCOaLn}T$urVd(oo=Q?TnP@a9jMUN%~El*O<`OaMz28 zGt3S{HoDRJ>Y^xG+-m}EqC(JQqxv{Q{=03vOFjaeVMB8d>|Lm} zbzUPYma5yby9^fmV=#}y9`0Dr3@OMEuXR!dNow>Bov|Hr(V}M=G80+DFN3Hkk|b@D z-bdu(HW}O|C$>p)o4oLdyz+=lRy0l0ZogO|pzcLI_2Y>u&MIvn9!A?M3hJ%_Pd`>$ ctE#uCf-`=oqM$x@*3*yGrX3aLtOsuW3yB~EX#fBK literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/exceptions.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/exceptions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c5846305dc53c821aa5c57b0ffdb57d6466c4017 GIT binary patch literal 7181 zcmd^EO>7&-6`tMY&ype~>&N=Bm1H9|wirm1f8@jwq|}P-Bx)1cwd4e)<*ZlSp|ml% z%gin%Q;`854Ace^!~vRGMw>Q33p7S@Fna2thaL;`BEv1}EE*(04@GZuq#!|0eQ)-M z5+x_ip{Fjy+1Yt--n@D9=Dlx5e@>^91fC~Oe>!ip6Y>xI2%e~4SwAWea+91TI?;t9 zDG52DB<94Dl#@!4T%;7uMN6?c9rOHn)*ocM$I+xRvB6ov^i`|i-ach+0_wd$E zXzkk6y0_Y$>G>Bbnu)p6gjsbXCycz~%BRYXVVPRdm8a<&6>8?G8=0w=sT)0O0wE*1 ziRUz%zHI5V=%(_FY7SLP_>~dd^ouhyr%ztWQ!WG=+Fqq|(^mc>b?U7kVZt;m2RiDm zbi&H#QH|hf@+<3aLFFf~xRm4so#aGa$Vmy3AbOK7(Fl!#Ib(VxFlRwTQ|nQn#5pC_ zK#2oIrU{y)Nskx#Ij7vfnb5_8e2o+YJ$W^qYq~}*3AxlX$)p(Sru{)AB&onNVJbLX zg$DCgs#ZnGYo@|9!={R1VgpmGB~!_RffUD5>;-E{p^RC~#!qK~D*2*8O(&b=GG`VH zTYP5qxS5ES2oF7#84oxHGG3$M(2@!zh3)d1nQ@9gT{gcAWv4JXhJWZ3e)MPQ_MnjmAd~j10nXj%F0c`zE13 zmsPMTrtWLRrBJ8BOqd{!05jwRox>7TKYy941cv4BDYt3U0Lzo1z9 zH#)4xT`%33r{}UaUY&qjrK+HRqKG-F*xhjDs8tUOwaeUCDVOD`2-ylB5xUusQ2nNA}`3SSa`jb$+ zC)^}XKq1#7E97mUuLvvRiuAD%L~DUmNk*K?NNgAIvQ{kGptvo%QM*#6%#~HuFbzjl zGf_8U(_*24(@m&qzNp!@s@kXkPX5Zj&Euo9XJO;pvznnZ!=61|%`a%IbedVO)4XHP zmf6reH7V0zW6l<>d3$yaN);SmEmbZ)b6_^RNX^CBmyEet8$4*JtmQ9i^VFX8x8ZOY z@9b>3%DQ0W<<2b*oDCFz0%$hI*{`pVjiV&dd_8_w?*8E1?>qn0wI+A}RsPXB5YY@% znKaJV)JjxU-K2^crBcLtN>$&eXhokAS5*i^s>;&P&y@_*Va-ruXncl7V7M%<1Ur#y z=B9lce!g0kFh<-k1?GW2_*amim$Jd2VzfDuH^)hZmsQt;=z&L=o#Vj z-H+Z+wS1Clsfl81$GQ|rH`kWOblom7V8$5ZLfNff9to*HFHjR~F_laLydECmBa;--;x@koz4;X>Bgof}lD9`Nv{Oai&^1Ck>5gT@_(=Zl$seQZQ z26$rkjFx?MT0MB+z)|(|sh1{?|5$xx^3+QcGn1#LJhXvgv?UE7SvbM0mPdFE*anIC zEG-yCs?4xT!}vVmj&JMFXr3C2RCVa3%~DWO<4~9%J-$NUv}Z#=1n4|4<5A^JfBFG7 zLJ|0UlbDx53}h1pM^~0Kl!AI*9^`-(?X66nfJWc)f#^DTiJGEHv?A31LxU=r}9t(={Ce(2~BoY`P)i0!MBGP-#GJQXRPgZi8bV zJ^^kM8KN7u4~yMUWFo8^>-AQSG*CV))D;hGaImyDT+=X?hKR`ob{n}6F^vR>X;uI5 zDUO#8@w|Uqn94MfXf`tThe4;?r0ctTWc=TDU|+z+<}H?DdTGNR|+hoITU zzL4MeRJlv{?l5-f(?7#5h)l1L`(2M*i@crUR>%iy1Qgg+zBVWmv>^y!8=q-UD~3kO z2wWfT$-XA2+VY;AH1Vcz3+Og_8R*f{{?5wvl{I-US0xi~T+tY?d4~$Vb5JxJ#)9K+ zKJkP2iN$;Hvola!B{flqKDv78L+RG#8iDGaj&*$1VnVccRsNv;R(b=zdp#-GcZ(OG zpWw586pF3rT^D~L0Co?&Awna1R2O_K9=qC{i*hU;11uhQJN>=0$rN~1GX={TnX~jN zvL^h;C?x&xzN@POT%tY}MzEb{j28n9QKrHF zj)72y#joMVF91N@h#z6FeTy!kZ(*4KuD%7=sxgQ)afmf>?q@Rine29*@h@Q-9gRH$ zgZ!_(jE&(S<51WbJ{yv(@(|rZPx=shKZ^x!=`Fzs?-3;U@l!P18kPx6 z!5Kb=UN%|+w$$$K)sA2F-s-)#d*52e{j)#Iy2 zJ`iuL+)edgf1xIk4(0Qf&TGxy)=M;cZ9^n|9L8ajSnRk7pF;{3zlEQD0E%zfgkR$R ztI3gQ*J}G$1YX`=L=jV&UN`0)lf6)mZsJ`MaiwreFoa01T(0UGUa2!oQw;y_y2S<(OD$T-@EN51 zSC+F?OlWaxQE^OSW=c_JaZEsEaz|(D2UH3&9*d%(JM>MD~s{TOo}PaEJ@WZNKDR7OiwM2fjUDUVxL|?LRDq49m-$s*P+#96)IR4eV5M literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/param_functions.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/param_functions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aa4c0bca8385b4e34ba73e125a48636038c655e8 GIT binary patch literal 35118 zcmeHPU2qiFmF}6*{OD)&hd@F?q7eopp+CSj7y~vSevJWJV2ltRwWeF6hM8%(dqzU? zI8IfzYR$uLNaZ1Z@K*U@UtGz{Zf$MlZC|%`U(9Z5mrRu_Nu_pc^RyF_+J`*tch2n| zO}9o;%W)_Y515|Q-RItW?%z4zIrp^xH6Cw}@MqukFH_roFG;_q8|TkCn|S(vyCvyI z(oIQ~)IeIw1f~L+;8ZXZnhIs=rs^``sc4r?>R3p=M z>84D4D$aB`-JEHeYRR-twPxC;+5(c+IMuENv~6nS1e&dvR84DFWAtymzgoNVx6D@$ z-iA+m)JCmE3j`&tRc-olK=fiRxD$jL$D61YOi5b6ei9SE%-!taZUJ{#>!6bSzSZ-- zjcePkR@Tw(;n~JK9WI^@56|{0JUcu*ogP`bJnwgU-gkT6_wf52<-Y9lyzlkA@AJIh z?RhVI-tY0e@Atgl%kQ_B+ke6HexK+4e$V>@{C;&V20ZTv*L#ndYg32H+#y~E2f-cH z+_N%V<`HXUgn2q$GdJqt8DpLuE}n4@&!H;y9QN=WVIKENdeOu4QWc(;Jv>Lj6V~dq z0QIsw*2g?tuP_($@aP=(ynmJ7hqMkYE_O$`rV}2{lPpskIBA^f%6z9he6NA8llRc; zo;Rnt25PI?jy&VxJ_~NKvnQN4+=Fw@-JF=;^Qi5Fdf_jkQ(ao)T;LngB^S$W)N~20 zvYIZb=@Lo(w&;>e&?P%Px`gmXmA?)ysn9yadHK^_70BezN1MD+*6mk38nT92-1xDE zSqPKYFbjDTZE7{la!P#@dZyc>XR7EJ@_C%U8~8teK3b-xOKQ4=d^Wd_RMREv>yi`d zRp^o)N0+GA%6eie`sDhjz26vWd5e8Lw@3Z92Qy59r-MDk8=g0{XbgOMJ8D&n#t@RI zMPuC2&F489^SXKy+Gv-pjo$fMy6Dz7=t0%=48_B1QQunB*Rd&o9#P*@>buZ0y|$jY zUDGpa?Q}^}Yo|+Iͺ)T;g=r%R{QDd?F#oK(-L_3E8Z1L`z9m#`L8qs~cI`84dV z$CG)l95GFJ-q5*KM4ds+ySe5V>Q+7tZlUg3mLeift;-T5J?(5PK}=O4fxH|WO#KEZ zK^lw}L#MOL#n@RTomOVkTCr|IPv(ksS9B{^j9pvE=|)yb7h{v!`*|&!)QaJoSv(pH z6eA0Ysbnlr^*6JsHm7Gb6*tjy50uP8S{n=%>rZF1Mo!6TYB4lnB#RBIwqR;Weh^9A z%vxG*^y-blo?;7%EBSOTF{dPRhPhk}D`{P^ip~6!STJ?N)N{+l)GE@IrOAa)vTnca~F!iR1W{NVla(gyllwm*+g2)rgHP3l?M(TT~Km4&CC|V zrk2tk6yvH+m4I7;WW|V;GiiJpGZ0rtHxtHOF^;h_mJ)h)E|FETqB>Pi={fX3)slKf zNhcQ4N>a0mF-?q)RgBtHvDH}6vdV&eFl`k9Qia!%#JY|emUX%4XIXAD#JYO0*C(r3xT9tK6#`MTE3k|N)H|Ft5 zH8d-GASWwxb6PSd&s^E0b;Sh8Yqt#%W*PcJFUmTY37=%%KQdaA5!AJr?1ip~p8 zHnQnudCoB9q>;hk>$7?qbL}o}wqZzC{=-$}X*p@HSvhCODJ`p+SXnHSJt(64&wuCI z(K%%=96opdvKUfYiWrkcP0lJAjfbhqR95TalAcb>vznZ@G?fO3*9#_+ien2YvXWKH z^*N)b%Ga}9{x)?S}a&UIX#(AD<&ok)z0P9^3uGPm6we?=7JUro^k^$EInRQ zvN=eRROpSKb9InbfqZ>AH*aLIYOs+PA?bZ>dC4$U8SBBqu0vyPQOs?$5)@ZO*KPeE z8)BieY8aJy8H?p>k)Y_giC$w=peUBi2TXUHYw0Z|iX6)Ow<;tm-!>aGfT zXfPr6`qWcd1L{InNE21)ayh4GG*5qbP=Ciz)EmA`T^RyI#_0ClUReaYc4LmRkiTu(l^x=h_9)10e@E1E^dVEyq( zI}Ga%#yXAlP-A~ty|GPuzuIa=*M$VG8rM$EI@0VSY1}L6O+Bk;@)=n`309~C5wa=o zRQ6UWt32>mwvWob=#u$uEp_ezHZg;h4Vp!Qr?hfzq71xbJu9DAtQ>T_JU)78e0+4A z_v`g#6{=cK%8Q4GS&h%wbj z{VV5`R0>-@Pe{_U;`dM+*IaF2i_P3H^V-ZXR4t*eO65yNgfv;71;rFLd#X(vFj|0y;S>KuG&u%B9vzU2_f~&i2Vz6I8#j%tW)m`RPQ-g zy>Hq}Mr=)CA*dw*H#b-Z`__)@+PZA8DhsemI^0;oz!EsCt_${4t;bvv+VEc}M2pLk zf~h(!2dH?~y*OI98kTwiU-iB(i8NcExXwfYXN|L4*S3<=)qQiLXPE9RCRUL ztwB)ofHs;Ml^1nOC&Pqp%#5i<(wZ6c)Hu0ByTO!iUXlm6y9=hVsKX@jYPJhOeApbg zN7|q~5A-st(Z+W=Ymc%US*+V58q_RTUOApKPKU8zNsI%c{fwe#UGqyoE~(%`tAb63 z+j)2!szT1dq|3^zkq2P3a4Q#mxpTxFK|q_Mk5S$ab-VrY;T?*%m`G&h~e?HM#?S` zCZ)oClGz1Y`M&Gfn~Hg#JG=%uVLnzpThHt|>&14XNI`9Bsko#Xr2X=1msB?l3@vy-8dFzw#fYip@@6(^ANolIdm{MPh<{Ii zhRctnobyh)2i@iUqxS0fgrgw+FrWqt0bE0cAg*X73mv%b zC~U{Iv(SlaS78UPI}2U7b{BTy+EeJpbyuP1hk?SbzYY9#U{V_FQ=*OME>HTLX=Dfs5iHU(WUJ(IoJ^=v=CC!L!(!{pVThlb7i_>i z@<|8G4GcDjr?2DjXiCcs^pC+=%~)d}&`&~FKkOgm_7!V6nmR&3%ryRIB$v!2$H*j4#H6ia5->LjVVeY%O#;1)R!xGF zCZRu*K$=O2$|NXc67(<$zL^R@#O&^zW^+$ESgSOlw-vRa3X7uP-O(6*F_)H0~jyXH74dBep3r%;~g|vZiNo zONt@CdU0629Ar@aq zb6F$MS>Kg@ceP$>YXAPL4`2OC>T8PpytT6w!tbxT4wS<9{cS{Q=_o~sib-AjOZ7xG zNZmuFMxvUe-tkhLsAl48A*xl{E|=PfYL}XtOWTO*AZj~NJBaEes*9+dM0HCYeWf0v zb`jM}RG-w=RoYFIOf~Nzs$c4Sp|qE%7o^r5rF}&0r`8S-H9&6%i5j9>4iYs?GLH~7 zO7)EqH7>PxmktqinEG*qs28ckOGLda^$eGe5_JsJlZKYxzKWZY)EACC#i&Uum&?16 zW_8Q4+{&f!?XoDJ_g#I)J9R@fVvb=p9ZeE`E3cW$<{{b_n{Hn7FxbqOoy#Qlk+YfJ zi_vB}@$f`#Gi|b&%p)}XyVkWS#cfF=yQrDDL>}i?rj>-#VtwO=W@BA`6e21SOs{Lp zpN2z|0n(uZj%A#Su#^awl%*tlJHNbu;5&e)@a4*`jKH;gUf{v!8^a|>ZLEb&7l9Mt zY_0+)zW`~T3)&EAY_H;UYeaO(g4Gb1#A&;%uE?O50dNsFn*!jz=LP^1^zCBkyOY82 z8UU>J7Ipy!_u4Rc_hw3q7RfihF8yn+h?xJuzD;!NA4SZKw+}-hf_%;bs{Sj~=_@ph zbom~<4(q7ECOKB8Cm){tO4@B>6Z|qZ!LN-?h!WU@D1l9g64->OW)MuV`Kz?}=<-h?uPx`r2U}JH#_I!PUUDm~ z9O_2`2@J;=1y=@p*}5azgVQq=nHQR>D+xMicqUHd#>$EQcNfavd2RbGIx(MNc@Yh= z%10X%FI%nV=y;H1FFBhO|v^y{i{O&C~2Sd)3v)Ur9?K19wvNjUZzp)NSl7fR)Dhbqg8 znY@fLhWaILHpNi8pEC?ap~RgWKI~>ZRS`rK7)tFc^a4rs*+@#RL{hZtNMR3rKZkHQXcHRt>)lsqkw< zDxzWpHtLCLAZXJ_R1*P}I8n_6N?M3&C2-Y7R6Fr)BdUYo&UT^%q#{Z{Dxw6WB5D_b zt6ri6q#{bDcJ~m~Phe;-Q7=%<`-s|4@aX_i0|c%Hi5jBT4iYs?Z%2q4rCP>_8Yh_# z5p|gAJ3`cp1g>5p>SgN3QKF7fiC2gsNL6~3s1r80dJQ)vNw&e&%AQI~_h4jcX=w!K zZJCk0i9~~>frCfKv3+JMe8Y89RyyAz$L({Mwk@#R#vx^RC5)W$Tj920r$xzmiP65UC#r#VX(Lfhv?Jq0ef!+D zm2CnUA(wNEH3|WUZ{zMYPh&|r9$npeJ*}B%@x=1GEYH)j0cM`lO|(tPoWh5p{BY!V3?nPuB?0leD?v6AWrP4g zr;vo=JUfnewWbq3G?*c_nRWOd?fIWQ0=s#H=>2EaGzqPRfH% zmPbkq8gU8W?u|XxVvq*V;qtgu`fijsWJiiE$|Sc(&OP5{J%AaPfas(U{yn8Lz0F*Q zf>a3nB=BPd*60t;_Jhhl;D*IsJ=?bru~&y1Y5vTDESa2gA1P0YlPA5k-SKsHh28YV ze(Ks__=L02u~huV!OIhdGUcp*p&>iPX=q3c!Z(p7Af&U(`askSFj*y2U^Ni{NmLnp zSyJ|8t%3KCQ?8|4kgt;4f0BQYetBPC!0|m&`cKN^!*Uu4`Z?zwsif6T{oluV|NFyo zKNST@Ke*$PxaHpu*UMbkC}BZ}Y*pqds7MVR#&IbrB5Pnxp9b%)mCvq)*PxS#@OjX@ zh&9Z*&#@0tyH@iu-dMECWm$MYZxAb8eiFkQ%2L3Aw;7-_x>FBNeKz&eSAN!b?u)u} z!Z-x+0Z|fZEEd;pUIDxEE3bOJhU1_4!?IxHjY{9sl=YuC7Y6D9$%W7^q}-uFCN+c* z@CD5}D#N3iZa~#RgJ&>9Bp57_kwHx&Nd@m5VeGU>4!uElQ?fpiOGuN=x|I_pDk71X zz8XUeV^K-r10?z&fD;(;`B#o~9rD#Ft<%JpQD8E)IUK)HU5MLdbc@b~ERjg!m_4X2 zN;+gF(?DYP+HP3*#)8LIrZhroE=3;%sW6Gi`niTxK{?L@BnxS6y5ZzQS7xTu9{o;o zJ~3i#sLn~_v{k56o0Bcd!{XMZ>l|#++6m(yYgRht^`lt}LFiU0fj_KUgHX=v=vHU? z*D6_>YW~M$J``1zEmcTZDl#K3bA_*U zg$*#T;*~|317jl$)-__L%m0wUqGUQ4teGGgtk)jC_SwCk?)Ybzteaod-L(Cg(ZRsg z!9B%@NLe(gGLx{ONovf5PcE78fFu*uNoGAR#i*SiCQ|5H?7PtfObb#bO-cBf<765>0_LMQj$EFhs@R8PGtNUZM$gETt7B^QYjP&1b!i1_)qD=zeyMVOX~ho+V`b2^b6_OW9is0n>)W7`8f3NQfFzGRNqwU zJQof`N~2PJOQ}n$kC$4B+Cfx@eap|{rFOdI3s@>CzU2!Sb8cHiRk-y~@lrEA>o2!a zF80-h7)kRazT-)(@#nF|QZO8EeHx0^H2KFqZdEcAIG|wJxJ_z#2zO0==MnIQh@oV15&5FhCf97Vd9Svf2=c7x-0mz0jYcM z8vZ)sj}U*9`0KkPB}4F^!7gw~?iB@+pAE7oZwICJp2|*oS=%F}Nx?cBl z?x0uT`ba4$SaUvD^Mdt!$WyCV0MvRx%;P&=)+z$r60GwfsjYjXZnZ^9x?p|agLPT3 zUaXUvJ2$EoOYTw~kL$a2>r4T{clFzzG)+DY1u=DTu~ac1w?(;Zoz&60W~#ko(t)WK z{NJgQXa~eURv%4#eD85=XVs+_kCZ+V{8z&~-|>&NM>jsc|2WoNl^>ISEzJFRFKo-R zVf~ONA^5Xl9{5eR0!H5u{ND-t+&Ui#{;No`?V>5@c$ECX&d0Hys`9r${)mu2QaNSq zrC=a_>S-uMyQYqIO$1Yx5UlA4?@F%vlcSH)kK6V>j=jM3H_}#%Q=w)m)QYW{5rwWs z?f%~TWbY@r&u)CtJoq>^#D%>36P>;mWua!HQrDg*u_k8os;w^UBEj}Ru+iKe`6Tq{ z*u(56>KD!Zk7IkQb{YkjMZt?P?zB*g&f4LHR|-0}rFa8%rHPg-YtqteOp4S$O^TZt zEYtQQf8hC0_@`qeO@+cQcg0q)r0`kbjx8(v?OblivuCR){DaJR#;?LZ8({u- z{3`rgf`8tx!q)|V0e<>s3jagFdc}vre>2EZPy5i~cLi(K2dg1iU-xQp?=(W;pBD3Y z-OE}<;lCwVXMJe#q+kW|+tfB#g7u6Kg@3k=2kY&vD*Q=NZr-oL*9HFrzY2d@@L%++ z@GphAAMg5A__qcBykCW{3;qXw75=i|zvx%tUy2C%eJK3ff^}|73O^+ZUEGqwzZ4Za zX%mHiSFpkVAiJ;yg>Q+1XSSyB&$1>hO|!zkD{dC*S>Z2lsPN0^oACOxf%&&$B+@2Y zpQZj9TA$1L(fZ7|1+CBgThRKXK^Enmpw9z^TY?||rSH~ z3-JbP%+k!3T?j=KM3y?ax_%E7-WR1V*OLqJMm-P4tZ*Tg%JC%}4-Y>F#$+-^B5h(! zSn97~Ot{?8#@68=GoA44?kcw7Bs1RdYZ`6_m>)qUe`n3Q;9v23^zeb;zv{y@Tnn-& z@A)td3Bl^`Jb`OnbDmH|iJuNJ>)T#^U&S;`3RavaZ0hYK1#8a7c|u;WPWUhl=jvG2 z8$L|KO~I;eHM*pUaw~qLOCJdS%YIG68)5FklwZ?uNATZsOx0%5rTc<^#cy=!1HpgU zuW5KABINgL8tw@Gdp@E|_XX>NEk&1>ZF#n28tz276WL9U9t^=Yv1QY6jumI=#@0;3 zO;IY#(IrFNOjI!qeKpen_kw4zW*U$@g^ZM%X{ecojnkaq#neoLk2It|9n)|brXgPH zd?j!`P-+!4rO;3S literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/params.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/params.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1b113ad00258c0e10248d046ee6663cc5ab4cb9c GIT binary patch literal 25063 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 R6tVN&Gv|NH!4JLT{|En{t~3Au literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/requests.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/requests.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..928ada21f4c0dd149d428a89f7804fb36d4869dd GIT binary patch literal 296 zcmXv{yH3ME5WKS^g@-~xO-tb-21*cuA`JyXRur1(r08NV=7{Y(cF&Rg6SRB--@+eQ z3Jnz_9S7ba4 uolX}z2U1U(^PM@{Wyh{*_pVEu)dk$(K8H(gI%N0_rIagi`z0>0&w2~7^Hpj9 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/responses.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/responses.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e5c68cef8c64528a348d2d4c770a9225d63aa085 GIT binary patch literal 2424 zcmds3O>7fK6rT0&`e(7@I04$yR1AL-u3{UBsavW-+Ej zSOP4oa)4#PaWx*`IN*eu2yg;$QcVUp2{@&u1eD@lQ|Q>wCzK0R^;T@{zn6=B4Z21{XJ$&dZa-R1>foN+qP zrOT#8771&)4kLVgZt24O@c4Xfp)xeiRW03gmdI6aNIAYp43m<^ur4`d&(%CiblY^A z17)QVo-UM9G}y)f?jeFy!9Z%v5LD5K5y=pVyeb*eElG`c)YL7rOR%API@fStMI~^% zNOS|+E+trBaoZj?;c>X*!1`fXXWmS84jXQRVb}tnX*18Y@!+7ifO$rzahQT>%=0~s zU2s6zM@QE@ufTZ<$5U)Saelxy6QSmvrMY57;O*0-uG!;Y#^pu(_XTxQ<60 z&yQ2$wW-sHMTz7cPb#mW?KKehkOwksHxlQewl|{DO~Dfemi6KFk@C7=#2$(pk!5|r zlED(_4QV6tP(yjS(wz~nGy^*`9u>wf>@z3p7vUCJT{jJCvU;`CSktLp zrS3XZC9Ah+p-CJD^=X;$`AouFsn*b!K{`(9#>1^d@2T z=w3>L)U#r%!?W!egm!n2oTM0P_w%@pfw+Ob&+hJJaW7fz9jrb9nZ=;FbM5xE`zOBG z^Ii7D)9mTT+0)-#d6GTbOP<|^HK_6+;U_iC(QTq>zM^TiYqTwn)0*~iTel)hLerq) zG>!5b_T`n1M;Ltt@B>6&g^up!B0Uh?!rlOJ3;hz4CZ7}TH~NV8pOc-S4_ER< zFU8KWg~btiJ`alZKhx8t{}+A+HA=^LK8K0LDHIU%696wm%)cqUK6rzI$3Yvi!l&+^ zt(!pTVQfHaAg);H7NgYvD|1IL7ML4%Tb}7Uc?nQ(ZFB-Q^2ZmdOIl^2qSclbwGU>O zYyKqH)MgjwX6EPAS*>#MLUoz$hPe@i!+Paq+TAm{OGK+_KKDHkoK|~!*#o^~t#_#Q z1Z4IAXzpCUeSI@M`C0kt)bYnt$G=*A`gZj(JX6&jF*dG1p{JCfzAN-K@IpCFhnRAJ z54kuDKei9VUrdo?g%brj&J*auWqfiz>&LxL3%)cV4=3SGM=j!c1fmWNSriVOaKgyul_yXNecOTAf2T}pWvA$^0$Mx*tUr^465Y5FG26X3@vh`uNY z!WP>56FRjOJ>@O*{uX*`3zhqlDCC|=<9$UGCZ0*T9Yqn&33umr5bt;Pr3K|~{Wk>N z^L_~>Cx1nPklRd;-<;)cbAR;Hk#b@)le<~w%83{3AZ+`kG&6y|mS*;&M-z#eDe=+k P0+;&}GkNjRQ32$i)5>yH literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/routing.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/routing.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..340e77bf68d68026528d0f421662b9f55045e9cc GIT binary patch literal 82066 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 Jf+0;)?>}%2V?zJ{ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/staticfiles.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/staticfiles.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..50db3fa03633545e97dc168624b01347f7d27429 GIT binary patch literal 268 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/__pycache__/websockets.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/__pycache__/websockets.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f2da091bdd6e8a853778175c29d06b72b96d7023 GIT binary patch literal 345 zcmYL_&q~8U5XN_t6spi(^c4hiX!ItE2%`<)Chido3aK)qP{eKeBuy2Y=9wNqq0Jv^>(PLD;jgnB7%RU%MXm}r?6G6xiolGf1b=zoPsx83l(YO+NM7smY>r-NgXFQ0SX Ovy-0Ptk|U)QuG5-U}Sm# literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/_compat.py b/.venv/Lib/site-packages/fastapi/_compat.py new file mode 100644 index 0000000..c07e4a3 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/_compat.py @@ -0,0 +1,659 @@ +from collections import deque +from copy import copy +from dataclasses import dataclass, is_dataclass +from enum import Enum +from functools import lru_cache +from typing import ( + Any, + Callable, + Deque, + Dict, + FrozenSet, + List, + Mapping, + Sequence, + Set, + Tuple, + Type, + Union, +) + +from fastapi.exceptions import RequestErrorModel +from fastapi.types import IncEx, ModelNameMap, UnionType +from pydantic import BaseModel, create_model +from pydantic.version import VERSION as PYDANTIC_VERSION +from starlette.datastructures import UploadFile +from typing_extensions import Annotated, Literal, get_args, get_origin + +PYDANTIC_VERSION_MINOR_TUPLE = tuple(int(x) for x in PYDANTIC_VERSION.split(".")[:2]) +PYDANTIC_V2 = PYDANTIC_VERSION_MINOR_TUPLE[0] == 2 + + +sequence_annotation_to_type = { + Sequence: list, + List: list, + list: list, + Tuple: tuple, + tuple: tuple, + Set: set, + set: set, + FrozenSet: frozenset, + frozenset: frozenset, + Deque: deque, + deque: deque, +} + +sequence_types = tuple(sequence_annotation_to_type.keys()) + +Url: Type[Any] + +if PYDANTIC_V2: + from pydantic import PydanticSchemaGenerationError as PydanticSchemaGenerationError + from pydantic import TypeAdapter + from pydantic import ValidationError as ValidationError + from pydantic._internal._schema_generation_shared import ( # type: ignore[attr-defined] + GetJsonSchemaHandler as GetJsonSchemaHandler, + ) + from pydantic._internal._typing_extra import eval_type_lenient + from pydantic._internal._utils import lenient_issubclass as lenient_issubclass + from pydantic.fields import FieldInfo + from pydantic.json_schema import GenerateJsonSchema as GenerateJsonSchema + from pydantic.json_schema import JsonSchemaValue as JsonSchemaValue + from pydantic_core import CoreSchema as CoreSchema + from pydantic_core import PydanticUndefined, PydanticUndefinedType + from pydantic_core import Url as Url + + try: + from pydantic_core.core_schema import ( + with_info_plain_validator_function as with_info_plain_validator_function, + ) + except ImportError: # pragma: no cover + from pydantic_core.core_schema import ( + general_plain_validator_function as with_info_plain_validator_function, # noqa: F401 + ) + + RequiredParam = PydanticUndefined + Undefined = PydanticUndefined + UndefinedType = PydanticUndefinedType + evaluate_forwardref = eval_type_lenient + Validator = Any + + class BaseConfig: + pass + + class ErrorWrapper(Exception): + pass + + @dataclass + class ModelField: + field_info: FieldInfo + name: str + mode: Literal["validation", "serialization"] = "validation" + + @property + def alias(self) -> str: + a = self.field_info.alias + return a if a is not None else self.name + + @property + def required(self) -> bool: + return self.field_info.is_required() + + @property + def default(self) -> Any: + return self.get_default() + + @property + def type_(self) -> Any: + return self.field_info.annotation + + def __post_init__(self) -> None: + self._type_adapter: TypeAdapter[Any] = TypeAdapter( + Annotated[self.field_info.annotation, self.field_info] + ) + + def get_default(self) -> Any: + if self.field_info.is_required(): + return Undefined + return self.field_info.get_default(call_default_factory=True) + + def validate( + self, + value: Any, + values: Dict[str, Any] = {}, # noqa: B006 + *, + loc: Tuple[Union[int, str], ...] = (), + ) -> Tuple[Any, Union[List[Dict[str, Any]], None]]: + try: + return ( + self._type_adapter.validate_python(value, from_attributes=True), + None, + ) + except ValidationError as exc: + return None, _regenerate_error_with_loc( + errors=exc.errors(include_url=False), loc_prefix=loc + ) + + def serialize( + self, + value: Any, + *, + mode: Literal["json", "python"] = "json", + include: Union[IncEx, None] = None, + exclude: Union[IncEx, None] = None, + by_alias: bool = True, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + ) -> Any: + # What calls this code passes a value that already called + # self._type_adapter.validate_python(value) + return self._type_adapter.dump_python( + value, + mode=mode, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + + def __hash__(self) -> int: + # Each ModelField is unique for our purposes, to allow making a dict from + # ModelField to its JSON Schema. + return id(self) + + def get_annotation_from_field_info( + annotation: Any, field_info: FieldInfo, field_name: str + ) -> Any: + return annotation + + def _normalize_errors(errors: Sequence[Any]) -> List[Dict[str, Any]]: + return errors # type: ignore[return-value] + + def _model_rebuild(model: Type[BaseModel]) -> None: + model.model_rebuild() + + def _model_dump( + model: BaseModel, mode: Literal["json", "python"] = "json", **kwargs: Any + ) -> Any: + return model.model_dump(mode=mode, **kwargs) + + def _get_model_config(model: BaseModel) -> Any: + return model.model_config + + def get_schema_from_model_field( + *, + field: ModelField, + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + field_mapping: Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + separate_input_output_schemas: bool = True, + ) -> Dict[str, Any]: + override_mode: Union[Literal["validation"], None] = ( + None if separate_input_output_schemas else "validation" + ) + # This expects that GenerateJsonSchema was already used to generate the definitions + json_schema = field_mapping[(field, override_mode or field.mode)] + if "$ref" not in json_schema: + # TODO remove when deprecating Pydantic v1 + # Ref: https://github.com/pydantic/pydantic/blob/d61792cc42c80b13b23e3ffa74bc37ec7c77f7d1/pydantic/schema.py#L207 + json_schema["title"] = ( + field.field_info.title or field.alias.title().replace("_", " ") + ) + return json_schema + + def get_compat_model_name_map(fields: List[ModelField]) -> ModelNameMap: + return {} + + def get_definitions( + *, + fields: List[ModelField], + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + separate_input_output_schemas: bool = True, + ) -> Tuple[ + Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + Dict[str, Dict[str, Any]], + ]: + override_mode: Union[Literal["validation"], None] = ( + None if separate_input_output_schemas else "validation" + ) + inputs = [ + (field, override_mode or field.mode, field._type_adapter.core_schema) + for field in fields + ] + field_mapping, definitions = schema_generator.generate_definitions( + inputs=inputs + ) + return field_mapping, definitions # type: ignore[return-value] + + def is_scalar_field(field: ModelField) -> bool: + from fastapi import params + + return field_annotation_is_scalar( + field.field_info.annotation + ) and not isinstance(field.field_info, params.Body) + + def is_sequence_field(field: ModelField) -> bool: + return field_annotation_is_sequence(field.field_info.annotation) + + def is_scalar_sequence_field(field: ModelField) -> bool: + return field_annotation_is_scalar_sequence(field.field_info.annotation) + + def is_bytes_field(field: ModelField) -> bool: + return is_bytes_or_nonable_bytes_annotation(field.type_) + + def is_bytes_sequence_field(field: ModelField) -> bool: + return is_bytes_sequence_annotation(field.type_) + + def copy_field_info(*, field_info: FieldInfo, annotation: Any) -> FieldInfo: + cls = type(field_info) + merged_field_info = cls.from_annotation(annotation) + new_field_info = copy(field_info) + new_field_info.metadata = merged_field_info.metadata + new_field_info.annotation = merged_field_info.annotation + return new_field_info + + def serialize_sequence_value(*, field: ModelField, value: Any) -> Sequence[Any]: + origin_type = ( + get_origin(field.field_info.annotation) or field.field_info.annotation + ) + assert issubclass(origin_type, sequence_types) # type: ignore[arg-type] + return sequence_annotation_to_type[origin_type](value) # type: ignore[no-any-return] + + def get_missing_field_error(loc: Tuple[str, ...]) -> Dict[str, Any]: + error = ValidationError.from_exception_data( + "Field required", [{"type": "missing", "loc": loc, "input": {}}] + ).errors(include_url=False)[0] + error["input"] = None + return error # type: ignore[return-value] + + def create_body_model( + *, fields: Sequence[ModelField], model_name: str + ) -> Type[BaseModel]: + field_params = {f.name: (f.field_info.annotation, f.field_info) for f in fields} + BodyModel: Type[BaseModel] = create_model(model_name, **field_params) # type: ignore[call-overload] + return BodyModel + + def get_model_fields(model: Type[BaseModel]) -> List[ModelField]: + return [ + ModelField(field_info=field_info, name=name) + for name, field_info in model.model_fields.items() + ] + +else: + from fastapi.openapi.constants import REF_PREFIX as REF_PREFIX + from pydantic import AnyUrl as Url # noqa: F401 + from pydantic import ( # type: ignore[assignment] + BaseConfig as BaseConfig, # noqa: F401 + ) + from pydantic import ValidationError as ValidationError # noqa: F401 + from pydantic.class_validators import ( # type: ignore[no-redef] + Validator as Validator, # noqa: F401 + ) + from pydantic.error_wrappers import ( # type: ignore[no-redef] + ErrorWrapper as ErrorWrapper, # noqa: F401 + ) + from pydantic.errors import MissingError + from pydantic.fields import ( # type: ignore[attr-defined] + SHAPE_FROZENSET, + SHAPE_LIST, + SHAPE_SEQUENCE, + SHAPE_SET, + SHAPE_SINGLETON, + SHAPE_TUPLE, + SHAPE_TUPLE_ELLIPSIS, + ) + from pydantic.fields import FieldInfo as FieldInfo + from pydantic.fields import ( # type: ignore[no-redef,attr-defined] + ModelField as ModelField, # noqa: F401 + ) + + # Keeping old "Required" functionality from Pydantic V1, without + # shadowing typing.Required. + RequiredParam: Any = Ellipsis # type: ignore[no-redef] + from pydantic.fields import ( # type: ignore[no-redef,attr-defined] + Undefined as Undefined, + ) + from pydantic.fields import ( # type: ignore[no-redef, attr-defined] + UndefinedType as UndefinedType, # noqa: F401 + ) + from pydantic.schema import ( + field_schema, + get_flat_models_from_fields, + get_model_name_map, + model_process_schema, + ) + from pydantic.schema import ( # type: ignore[no-redef] # noqa: F401 + get_annotation_from_field_info as get_annotation_from_field_info, + ) + from pydantic.typing import ( # type: ignore[no-redef] + evaluate_forwardref as evaluate_forwardref, # noqa: F401 + ) + from pydantic.utils import ( # type: ignore[no-redef] + lenient_issubclass as lenient_issubclass, # noqa: F401 + ) + + GetJsonSchemaHandler = Any # type: ignore[assignment,misc] + JsonSchemaValue = Dict[str, Any] # type: ignore[misc] + CoreSchema = Any # type: ignore[assignment,misc] + + sequence_shapes = { + SHAPE_LIST, + SHAPE_SET, + SHAPE_FROZENSET, + SHAPE_TUPLE, + SHAPE_SEQUENCE, + SHAPE_TUPLE_ELLIPSIS, + } + sequence_shape_to_type = { + SHAPE_LIST: list, + SHAPE_SET: set, + SHAPE_TUPLE: tuple, + SHAPE_SEQUENCE: list, + SHAPE_TUPLE_ELLIPSIS: list, + } + + @dataclass + class GenerateJsonSchema: # type: ignore[no-redef] + ref_template: str + + class PydanticSchemaGenerationError(Exception): # type: ignore[no-redef] + pass + + def with_info_plain_validator_function( # type: ignore[misc] + function: Callable[..., Any], + *, + ref: Union[str, None] = None, + metadata: Any = None, + serialization: Any = None, + ) -> Any: + return {} + + def get_model_definitions( + *, + flat_models: Set[Union[Type[BaseModel], Type[Enum]]], + model_name_map: Dict[Union[Type[BaseModel], Type[Enum]], str], + ) -> Dict[str, Any]: + definitions: Dict[str, Dict[str, Any]] = {} + for model in flat_models: + m_schema, m_definitions, m_nested_models = model_process_schema( + model, model_name_map=model_name_map, ref_prefix=REF_PREFIX + ) + definitions.update(m_definitions) + model_name = model_name_map[model] + if "description" in m_schema: + m_schema["description"] = m_schema["description"].split("\f")[0] + definitions[model_name] = m_schema + return definitions + + def is_pv1_scalar_field(field: ModelField) -> bool: + from fastapi import params + + field_info = field.field_info + if not ( + field.shape == SHAPE_SINGLETON # type: ignore[attr-defined] + and not lenient_issubclass(field.type_, BaseModel) + and not lenient_issubclass(field.type_, dict) + and not field_annotation_is_sequence(field.type_) + and not is_dataclass(field.type_) + and not isinstance(field_info, params.Body) + ): + return False + if field.sub_fields: # type: ignore[attr-defined] + if not all( + is_pv1_scalar_field(f) + for f in field.sub_fields # type: ignore[attr-defined] + ): + return False + return True + + def is_pv1_scalar_sequence_field(field: ModelField) -> bool: + if (field.shape in sequence_shapes) and not lenient_issubclass( # type: ignore[attr-defined] + field.type_, BaseModel + ): + if field.sub_fields is not None: # type: ignore[attr-defined] + for sub_field in field.sub_fields: # type: ignore[attr-defined] + if not is_pv1_scalar_field(sub_field): + return False + return True + if _annotation_is_sequence(field.type_): + return True + return False + + def _normalize_errors(errors: Sequence[Any]) -> List[Dict[str, Any]]: + use_errors: List[Any] = [] + for error in errors: + if isinstance(error, ErrorWrapper): + new_errors = ValidationError( # type: ignore[call-arg] + errors=[error], model=RequestErrorModel + ).errors() + use_errors.extend(new_errors) + elif isinstance(error, list): + use_errors.extend(_normalize_errors(error)) + else: + use_errors.append(error) + return use_errors + + def _model_rebuild(model: Type[BaseModel]) -> None: + model.update_forward_refs() + + def _model_dump( + model: BaseModel, mode: Literal["json", "python"] = "json", **kwargs: Any + ) -> Any: + return model.dict(**kwargs) + + def _get_model_config(model: BaseModel) -> Any: + return model.__config__ # type: ignore[attr-defined] + + def get_schema_from_model_field( + *, + field: ModelField, + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + field_mapping: Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + separate_input_output_schemas: bool = True, + ) -> Dict[str, Any]: + # This expects that GenerateJsonSchema was already used to generate the definitions + return field_schema( # type: ignore[no-any-return] + field, model_name_map=model_name_map, ref_prefix=REF_PREFIX + )[0] + + def get_compat_model_name_map(fields: List[ModelField]) -> ModelNameMap: + models = get_flat_models_from_fields(fields, known_models=set()) + return get_model_name_map(models) # type: ignore[no-any-return] + + def get_definitions( + *, + fields: List[ModelField], + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + separate_input_output_schemas: bool = True, + ) -> Tuple[ + Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + Dict[str, Dict[str, Any]], + ]: + models = get_flat_models_from_fields(fields, known_models=set()) + return {}, get_model_definitions( + flat_models=models, model_name_map=model_name_map + ) + + def is_scalar_field(field: ModelField) -> bool: + return is_pv1_scalar_field(field) + + def is_sequence_field(field: ModelField) -> bool: + return field.shape in sequence_shapes or _annotation_is_sequence(field.type_) # type: ignore[attr-defined] + + def is_scalar_sequence_field(field: ModelField) -> bool: + return is_pv1_scalar_sequence_field(field) + + def is_bytes_field(field: ModelField) -> bool: + return lenient_issubclass(field.type_, bytes) + + def is_bytes_sequence_field(field: ModelField) -> bool: + return field.shape in sequence_shapes and lenient_issubclass(field.type_, bytes) # type: ignore[attr-defined] + + def copy_field_info(*, field_info: FieldInfo, annotation: Any) -> FieldInfo: + return copy(field_info) + + def serialize_sequence_value(*, field: ModelField, value: Any) -> Sequence[Any]: + return sequence_shape_to_type[field.shape](value) # type: ignore[no-any-return,attr-defined] + + def get_missing_field_error(loc: Tuple[str, ...]) -> Dict[str, Any]: + missing_field_error = ErrorWrapper(MissingError(), loc=loc) # type: ignore[call-arg] + new_error = ValidationError([missing_field_error], RequestErrorModel) + return new_error.errors()[0] # type: ignore[return-value] + + def create_body_model( + *, fields: Sequence[ModelField], model_name: str + ) -> Type[BaseModel]: + BodyModel = create_model(model_name) + for f in fields: + BodyModel.__fields__[f.name] = f # type: ignore[index] + return BodyModel + + def get_model_fields(model: Type[BaseModel]) -> List[ModelField]: + return list(model.__fields__.values()) # type: ignore[attr-defined] + + +def _regenerate_error_with_loc( + *, errors: Sequence[Any], loc_prefix: Tuple[Union[str, int], ...] +) -> List[Dict[str, Any]]: + updated_loc_errors: List[Any] = [ + {**err, "loc": loc_prefix + err.get("loc", ())} + for err in _normalize_errors(errors) + ] + + return updated_loc_errors + + +def _annotation_is_sequence(annotation: Union[Type[Any], None]) -> bool: + if lenient_issubclass(annotation, (str, bytes)): + return False + return lenient_issubclass(annotation, sequence_types) + + +def field_annotation_is_sequence(annotation: Union[Type[Any], None]) -> bool: + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + for arg in get_args(annotation): + if field_annotation_is_sequence(arg): + return True + return False + return _annotation_is_sequence(annotation) or _annotation_is_sequence( + get_origin(annotation) + ) + + +def value_is_sequence(value: Any) -> bool: + return isinstance(value, sequence_types) and not isinstance(value, (str, bytes)) # type: ignore[arg-type] + + +def _annotation_is_complex(annotation: Union[Type[Any], None]) -> bool: + return ( + lenient_issubclass(annotation, (BaseModel, Mapping, UploadFile)) + or _annotation_is_sequence(annotation) + or is_dataclass(annotation) + ) + + +def field_annotation_is_complex(annotation: Union[Type[Any], None]) -> bool: + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + return any(field_annotation_is_complex(arg) for arg in get_args(annotation)) + + return ( + _annotation_is_complex(annotation) + or _annotation_is_complex(origin) + or hasattr(origin, "__pydantic_core_schema__") + or hasattr(origin, "__get_pydantic_core_schema__") + ) + + +def field_annotation_is_scalar(annotation: Any) -> bool: + # handle Ellipsis here to make tuple[int, ...] work nicely + return annotation is Ellipsis or not field_annotation_is_complex(annotation) + + +def field_annotation_is_scalar_sequence(annotation: Union[Type[Any], None]) -> bool: + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + at_least_one_scalar_sequence = False + for arg in get_args(annotation): + if field_annotation_is_scalar_sequence(arg): + at_least_one_scalar_sequence = True + continue + elif not field_annotation_is_scalar(arg): + return False + return at_least_one_scalar_sequence + return field_annotation_is_sequence(annotation) and all( + field_annotation_is_scalar(sub_annotation) + for sub_annotation in get_args(annotation) + ) + + +def is_bytes_or_nonable_bytes_annotation(annotation: Any) -> bool: + if lenient_issubclass(annotation, bytes): + return True + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + for arg in get_args(annotation): + if lenient_issubclass(arg, bytes): + return True + return False + + +def is_uploadfile_or_nonable_uploadfile_annotation(annotation: Any) -> bool: + if lenient_issubclass(annotation, UploadFile): + return True + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + for arg in get_args(annotation): + if lenient_issubclass(arg, UploadFile): + return True + return False + + +def is_bytes_sequence_annotation(annotation: Any) -> bool: + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + at_least_one = False + for arg in get_args(annotation): + if is_bytes_sequence_annotation(arg): + at_least_one = True + continue + return at_least_one + return field_annotation_is_sequence(annotation) and all( + is_bytes_or_nonable_bytes_annotation(sub_annotation) + for sub_annotation in get_args(annotation) + ) + + +def is_uploadfile_sequence_annotation(annotation: Any) -> bool: + origin = get_origin(annotation) + if origin is Union or origin is UnionType: + at_least_one = False + for arg in get_args(annotation): + if is_uploadfile_sequence_annotation(arg): + at_least_one = True + continue + return at_least_one + return field_annotation_is_sequence(annotation) and all( + is_uploadfile_or_nonable_uploadfile_annotation(sub_annotation) + for sub_annotation in get_args(annotation) + ) + + +@lru_cache +def get_cached_model_fields(model: Type[BaseModel]) -> List[ModelField]: + return get_model_fields(model) diff --git a/.venv/Lib/site-packages/fastapi/applications.py b/.venv/Lib/site-packages/fastapi/applications.py new file mode 100644 index 0000000..6d427cd --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/applications.py @@ -0,0 +1,4585 @@ +from enum import Enum +from typing import ( + Any, + Awaitable, + Callable, + Coroutine, + Dict, + List, + Optional, + Sequence, + Type, + TypeVar, + Union, +) + +from fastapi import routing +from fastapi.datastructures import Default, DefaultPlaceholder +from fastapi.exception_handlers import ( + http_exception_handler, + request_validation_exception_handler, + websocket_request_validation_exception_handler, +) +from fastapi.exceptions import RequestValidationError, WebSocketRequestValidationError +from fastapi.logger import logger +from fastapi.openapi.docs import ( + get_redoc_html, + get_swagger_ui_html, + get_swagger_ui_oauth2_redirect_html, +) +from fastapi.openapi.utils import get_openapi +from fastapi.params import Depends +from fastapi.types import DecoratedCallable, IncEx +from fastapi.utils import generate_unique_id +from starlette.applications import Starlette +from starlette.datastructures import State +from starlette.exceptions import HTTPException +from starlette.middleware import Middleware +from starlette.middleware.base import BaseHTTPMiddleware +from starlette.requests import Request +from starlette.responses import HTMLResponse, JSONResponse, Response +from starlette.routing import BaseRoute +from starlette.types import ASGIApp, Lifespan, Receive, Scope, Send +from typing_extensions import Annotated, Doc, deprecated + +AppType = TypeVar("AppType", bound="FastAPI") + + +class FastAPI(Starlette): + """ + `FastAPI` app class, the main entrypoint to use FastAPI. + + Read more in the + [FastAPI docs for First Steps](https://fastapi.tiangolo.com/tutorial/first-steps/). + + ## Example + + ```python + from fastapi import FastAPI + + app = FastAPI() + ``` + """ + + def __init__( + self: AppType, + *, + debug: Annotated[ + bool, + Doc( + """ + Boolean indicating if debug tracebacks should be returned on server + errors. + + Read more in the + [Starlette docs for Applications](https://www.starlette.io/applications/#instantiating-the-application). + """ + ), + ] = False, + routes: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + **Note**: you probably shouldn't use this parameter, it is inherited + from Starlette and supported for compatibility. + + --- + + A list of routes to serve incoming HTTP and WebSocket requests. + """ + ), + deprecated( + """ + You normally wouldn't use this parameter with FastAPI, it is inherited + from Starlette and supported for compatibility. + + In FastAPI, you normally would use the *path operation methods*, + like `app.get()`, `app.post()`, etc. + """ + ), + ] = None, + title: Annotated[ + str, + Doc( + """ + The title of the API. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(title="ChimichangApp") + ``` + """ + ), + ] = "FastAPI", + summary: Annotated[ + Optional[str], + Doc( + """ + A short summary of the API. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(summary="Deadpond's favorite app. Nuff said.") + ``` + """ + ), + ] = None, + description: Annotated[ + str, + Doc( + ''' + A description of the API. Supports Markdown (using + [CommonMark syntax](https://commonmark.org/)). + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI( + description=""" + ChimichangApp API helps you do awesome stuff. 🚀 + + ## Items + + You can **read items**. + + ## Users + + You will be able to: + + * **Create users** (_not implemented_). + * **Read users** (_not implemented_). + + """ + ) + ``` + ''' + ), + ] = "", + version: Annotated[ + str, + Doc( + """ + The version of the API. + + **Note** This is the version of your application, not the version of + the OpenAPI specification nor the version of FastAPI being used. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(version="0.0.1") + ``` + """ + ), + ] = "0.1.0", + openapi_url: Annotated[ + Optional[str], + Doc( + """ + The URL where the OpenAPI schema will be served from. + + If you set it to `None`, no OpenAPI schema will be served publicly, and + the default automatic endpoints `/docs` and `/redoc` will also be + disabled. + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#openapi-url). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(openapi_url="/api/v1/openapi.json") + ``` + """ + ), + ] = "/openapi.json", + openapi_tags: Annotated[ + Optional[List[Dict[str, Any]]], + Doc( + """ + A list of tags used by OpenAPI, these are the same `tags` you can set + in the *path operations*, like: + + * `@app.get("/users/", tags=["users"])` + * `@app.get("/items/", tags=["items"])` + + The order of the tags can be used to specify the order shown in + tools like Swagger UI, used in the automatic path `/docs`. + + It's not required to specify all the tags used. + + The tags that are not declared MAY be organized randomly or based + on the tools' logic. Each tag name in the list MUST be unique. + + The value of each item is a `dict` containing: + + * `name`: The name of the tag. + * `description`: A short description of the tag. + [CommonMark syntax](https://commonmark.org/) MAY be used for rich + text representation. + * `externalDocs`: Additional external documentation for this tag. If + provided, it would contain a `dict` with: + * `description`: A short description of the target documentation. + [CommonMark syntax](https://commonmark.org/) MAY be used for + rich text representation. + * `url`: The URL for the target documentation. Value MUST be in + the form of a URL. + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-tags). + + **Example** + + ```python + from fastapi import FastAPI + + tags_metadata = [ + { + "name": "users", + "description": "Operations with users. The **login** logic is also here.", + }, + { + "name": "items", + "description": "Manage items. So _fancy_ they have their own docs.", + "externalDocs": { + "description": "Items external docs", + "url": "https://fastapi.tiangolo.com/", + }, + }, + ] + + app = FastAPI(openapi_tags=tags_metadata) + ``` + """ + ), + ] = None, + servers: Annotated[ + Optional[List[Dict[str, Union[str, Any]]]], + Doc( + """ + A `list` of `dict`s with connectivity information to a target server. + + You would use it, for example, if your application is served from + different domains and you want to use the same Swagger UI in the + browser to interact with each of them (instead of having multiple + browser tabs open). Or if you want to leave fixed the possible URLs. + + If the servers `list` is not provided, or is an empty `list`, the + default value would be a `dict` with a `url` value of `/`. + + Each item in the `list` is a `dict` containing: + + * `url`: A URL to the target host. This URL supports Server Variables + and MAY be relative, to indicate that the host location is relative + to the location where the OpenAPI document is being served. Variable + substitutions will be made when a variable is named in `{`brackets`}`. + * `description`: An optional string describing the host designated by + the URL. [CommonMark syntax](https://commonmark.org/) MAY be used for + rich text representation. + * `variables`: A `dict` between a variable name and its value. The value + is used for substitution in the server's URL template. + + Read more in the + [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/#additional-servers). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI( + servers=[ + {"url": "https://stag.example.com", "description": "Staging environment"}, + {"url": "https://prod.example.com", "description": "Production environment"}, + ] + ) + ``` + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of global dependencies, they will be applied to each + *path operation*, including in sub-routers. + + Read more about it in the + [FastAPI docs for Global Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/global-dependencies/). + + **Example** + + ```python + from fastapi import Depends, FastAPI + + from .dependencies import func_dep_1, func_dep_2 + + app = FastAPI(dependencies=[Depends(func_dep_1), Depends(func_dep_2)]) + ``` + """ + ), + ] = None, + default_response_class: Annotated[ + Type[Response], + Doc( + """ + The default response class to be used. + + Read more in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class). + + **Example** + + ```python + from fastapi import FastAPI + from fastapi.responses import ORJSONResponse + + app = FastAPI(default_response_class=ORJSONResponse) + ``` + """ + ), + ] = Default(JSONResponse), + redirect_slashes: Annotated[ + bool, + Doc( + """ + Whether to detect and redirect slashes in URLs when the client doesn't + use the same format. + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(redirect_slashes=True) # the default + + @app.get("/items/") + async def read_items(): + return [{"item_id": "Foo"}] + ``` + + With this app, if a client goes to `/items` (without a trailing slash), + they will be automatically redirected with an HTTP status code of 307 + to `/items/`. + """ + ), + ] = True, + docs_url: Annotated[ + Optional[str], + Doc( + """ + The path to the automatic interactive API documentation. + It is handled in the browser by Swagger UI. + + The default URL is `/docs`. You can disable it by setting it to `None`. + + If `openapi_url` is set to `None`, this will be automatically disabled. + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(docs_url="/documentation", redoc_url=None) + ``` + """ + ), + ] = "/docs", + redoc_url: Annotated[ + Optional[str], + Doc( + """ + The path to the alternative automatic interactive API documentation + provided by ReDoc. + + The default URL is `/redoc`. You can disable it by setting it to `None`. + + If `openapi_url` is set to `None`, this will be automatically disabled. + + Read more in the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#docs-urls). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(docs_url="/documentation", redoc_url="redocumentation") + ``` + """ + ), + ] = "/redoc", + swagger_ui_oauth2_redirect_url: Annotated[ + Optional[str], + Doc( + """ + The OAuth2 redirect endpoint for the Swagger UI. + + By default it is `/docs/oauth2-redirect`. + + This is only used if you use OAuth2 (with the "Authorize" button) + with Swagger UI. + """ + ), + ] = "/docs/oauth2-redirect", + swagger_ui_init_oauth: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + OAuth2 configuration for the Swagger UI, by default shown at `/docs`. + + Read more about the available configuration options in the + [Swagger UI docs](https://swagger.io/docs/open-source-tools/swagger-ui/usage/oauth2/). + """ + ), + ] = None, + middleware: Annotated[ + Optional[Sequence[Middleware]], + Doc( + """ + List of middleware to be added when creating the application. + + In FastAPI you would normally do this with `app.add_middleware()` + instead. + + Read more in the + [FastAPI docs for Middleware](https://fastapi.tiangolo.com/tutorial/middleware/). + """ + ), + ] = None, + exception_handlers: Annotated[ + Optional[ + Dict[ + Union[int, Type[Exception]], + Callable[[Request, Any], Coroutine[Any, Any, Response]], + ] + ], + Doc( + """ + A dictionary with handlers for exceptions. + + In FastAPI, you would normally use the decorator + `@app.exception_handler()`. + + Read more in the + [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/). + """ + ), + ] = None, + on_startup: Annotated[ + Optional[Sequence[Callable[[], Any]]], + Doc( + """ + A list of startup event handler functions. + + You should instead use the `lifespan` handlers. + + Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/). + """ + ), + ] = None, + on_shutdown: Annotated[ + Optional[Sequence[Callable[[], Any]]], + Doc( + """ + A list of shutdown event handler functions. + + You should instead use the `lifespan` handlers. + + Read more in the + [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/). + """ + ), + ] = None, + lifespan: Annotated[ + Optional[Lifespan[AppType]], + Doc( + """ + A `Lifespan` context manager handler. This replaces `startup` and + `shutdown` functions with a single context manager. + + Read more in the + [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/). + """ + ), + ] = None, + terms_of_service: Annotated[ + Optional[str], + Doc( + """ + A URL to the Terms of Service for your API. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more at the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + app = FastAPI(terms_of_service="http://example.com/terms/") + ``` + """ + ), + ] = None, + contact: Annotated[ + Optional[Dict[str, Union[str, Any]]], + Doc( + """ + A dictionary with the contact information for the exposed API. + + It can contain several fields. + + * `name`: (`str`) The name of the contact person/organization. + * `url`: (`str`) A URL pointing to the contact information. MUST be in + the format of a URL. + * `email`: (`str`) The email address of the contact person/organization. + MUST be in the format of an email address. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more at the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + app = FastAPI( + contact={ + "name": "Deadpoolio the Amazing", + "url": "http://x-force.example.com/contact/", + "email": "dp@x-force.example.com", + } + ) + ``` + """ + ), + ] = None, + license_info: Annotated[ + Optional[Dict[str, Union[str, Any]]], + Doc( + """ + A dictionary with the license information for the exposed API. + + It can contain several fields. + + * `name`: (`str`) **REQUIRED** (if a `license_info` is set). The + license name used for the API. + * `identifier`: (`str`) An [SPDX](https://spdx.dev/) license expression + for the API. The `identifier` field is mutually exclusive of the `url` + field. Available since OpenAPI 3.1.0, FastAPI 0.99.0. + * `url`: (`str`) A URL to the license used for the API. This MUST be + the format of a URL. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more at the + [FastAPI docs for Metadata and Docs URLs](https://fastapi.tiangolo.com/tutorial/metadata/#metadata-for-api). + + **Example** + + ```python + app = FastAPI( + license_info={ + "name": "Apache 2.0", + "url": "https://www.apache.org/licenses/LICENSE-2.0.html", + } + ) + ``` + """ + ), + ] = None, + openapi_prefix: Annotated[ + str, + Doc( + """ + A URL prefix for the OpenAPI URL. + """ + ), + deprecated( + """ + "openapi_prefix" has been deprecated in favor of "root_path", which + follows more closely the ASGI standard, is simpler, and more + automatic. + """ + ), + ] = "", + root_path: Annotated[ + str, + Doc( + """ + A path prefix handled by a proxy that is not seen by the application + but is seen by external clients, which affects things like Swagger UI. + + Read more about it at the + [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(root_path="/api/v1") + ``` + """ + ), + ] = "", + root_path_in_servers: Annotated[ + bool, + Doc( + """ + To disable automatically generating the URLs in the `servers` field + in the autogenerated OpenAPI using the `root_path`. + + Read more about it in the + [FastAPI docs for Behind a Proxy](https://fastapi.tiangolo.com/advanced/behind-a-proxy/#disable-automatic-server-from-root_path). + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI(root_path_in_servers=False) + ``` + """ + ), + ] = True, + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses to be shown in OpenAPI. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/). + + And in the + [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + OpenAPI callbacks that should apply to all *path operations*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + webhooks: Annotated[ + Optional[routing.APIRouter], + Doc( + """ + Add OpenAPI webhooks. This is similar to `callbacks` but it doesn't + depend on specific *path operations*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + **Note**: This is available since OpenAPI 3.1.0, FastAPI 0.99.0. + + Read more about it in the + [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark all *path operations* as deprecated. You probably don't need it, + but it's available. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) all the *path operations* in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + swagger_ui_parameters: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Parameters to configure Swagger UI, the autogenerated interactive API + documentation (by default at `/docs`). + + Read more about it in the + [FastAPI docs about how to Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + separate_input_output_schemas: Annotated[ + bool, + Doc( + """ + Whether to generate separate OpenAPI schemas for request body and + response body when the results would be more precise. + + This is particularly useful when automatically generating clients. + + For example, if you have a model like: + + ```python + from pydantic import BaseModel + + class Item(BaseModel): + name: str + tags: list[str] = [] + ``` + + When `Item` is used for input, a request body, `tags` is not required, + the client doesn't have to provide it. + + But when using `Item` for output, for a response body, `tags` is always + available because it has a default value, even if it's just an empty + list. So, the client should be able to always expect it. + + In this case, there would be two different schemas, one for input and + another one for output. + """ + ), + ] = True, + **extra: Annotated[ + Any, + Doc( + """ + Extra keyword arguments to be stored in the app, not used by FastAPI + anywhere. + """ + ), + ], + ) -> None: + self.debug = debug + self.title = title + self.summary = summary + self.description = description + self.version = version + self.terms_of_service = terms_of_service + self.contact = contact + self.license_info = license_info + self.openapi_url = openapi_url + self.openapi_tags = openapi_tags + self.root_path_in_servers = root_path_in_servers + self.docs_url = docs_url + self.redoc_url = redoc_url + self.swagger_ui_oauth2_redirect_url = swagger_ui_oauth2_redirect_url + self.swagger_ui_init_oauth = swagger_ui_init_oauth + self.swagger_ui_parameters = swagger_ui_parameters + self.servers = servers or [] + self.separate_input_output_schemas = separate_input_output_schemas + self.extra = extra + self.openapi_version: Annotated[ + str, + Doc( + """ + The version string of OpenAPI. + + FastAPI will generate OpenAPI version 3.1.0, and will output that as + the OpenAPI version. But some tools, even though they might be + compatible with OpenAPI 3.1.0, might not recognize it as a valid. + + So you could override this value to trick those tools into using + the generated OpenAPI. Have in mind that this is a hack. But if you + avoid using features added in OpenAPI 3.1.0, it might work for your + use case. + + This is not passed as a parameter to the `FastAPI` class to avoid + giving the false idea that FastAPI would generate a different OpenAPI + schema. It is only available as an attribute. + + **Example** + + ```python + from fastapi import FastAPI + + app = FastAPI() + + app.openapi_version = "3.0.2" + ``` + """ + ), + ] = "3.1.0" + self.openapi_schema: Optional[Dict[str, Any]] = None + if self.openapi_url: + assert self.title, "A title must be provided for OpenAPI, e.g.: 'My API'" + assert self.version, "A version must be provided for OpenAPI, e.g.: '2.1.0'" + # TODO: remove when discarding the openapi_prefix parameter + if openapi_prefix: + logger.warning( + '"openapi_prefix" has been deprecated in favor of "root_path", which ' + "follows more closely the ASGI standard, is simpler, and more " + "automatic. Check the docs at " + "https://fastapi.tiangolo.com/advanced/sub-applications/" + ) + self.webhooks: Annotated[ + routing.APIRouter, + Doc( + """ + The `app.webhooks` attribute is an `APIRouter` with the *path + operations* that will be used just for documentation of webhooks. + + Read more about it in the + [FastAPI docs for OpenAPI Webhooks](https://fastapi.tiangolo.com/advanced/openapi-webhooks/). + """ + ), + ] = webhooks or routing.APIRouter() + self.root_path = root_path or openapi_prefix + self.state: Annotated[ + State, + Doc( + """ + A state object for the application. This is the same object for the + entire application, it doesn't change from request to request. + + You normally wouldn't use this in FastAPI, for most of the cases you + would instead use FastAPI dependencies. + + This is simply inherited from Starlette. + + Read more about it in the + [Starlette docs for Applications](https://www.starlette.io/applications/#storing-state-on-the-app-instance). + """ + ), + ] = State() + self.dependency_overrides: Annotated[ + Dict[Callable[..., Any], Callable[..., Any]], + Doc( + """ + A dictionary with overrides for the dependencies. + + Each key is the original dependency callable, and the value is the + actual dependency that should be called. + + This is for testing, to replace expensive dependencies with testing + versions. + + Read more about it in the + [FastAPI docs for Testing Dependencies with Overrides](https://fastapi.tiangolo.com/advanced/testing-dependencies/). + """ + ), + ] = {} + self.router: routing.APIRouter = routing.APIRouter( + routes=routes, + redirect_slashes=redirect_slashes, + dependency_overrides_provider=self, + on_startup=on_startup, + on_shutdown=on_shutdown, + lifespan=lifespan, + default_response_class=default_response_class, + dependencies=dependencies, + callbacks=callbacks, + deprecated=deprecated, + include_in_schema=include_in_schema, + responses=responses, + generate_unique_id_function=generate_unique_id_function, + ) + self.exception_handlers: Dict[ + Any, Callable[[Request, Any], Union[Response, Awaitable[Response]]] + ] = {} if exception_handlers is None else dict(exception_handlers) + self.exception_handlers.setdefault(HTTPException, http_exception_handler) + self.exception_handlers.setdefault( + RequestValidationError, request_validation_exception_handler + ) + self.exception_handlers.setdefault( + WebSocketRequestValidationError, + # Starlette still has incorrect type specification for the handlers + websocket_request_validation_exception_handler, # type: ignore + ) + + self.user_middleware: List[Middleware] = ( + [] if middleware is None else list(middleware) + ) + self.middleware_stack: Union[ASGIApp, None] = None + self.setup() + + def openapi(self) -> Dict[str, Any]: + """ + Generate the OpenAPI schema of the application. This is called by FastAPI + internally. + + The first time it is called it stores the result in the attribute + `app.openapi_schema`, and next times it is called, it just returns that same + result. To avoid the cost of generating the schema every time. + + If you need to modify the generated OpenAPI schema, you could modify it. + + Read more in the + [FastAPI docs for OpenAPI](https://fastapi.tiangolo.com/how-to/extending-openapi/). + """ + if not self.openapi_schema: + self.openapi_schema = get_openapi( + title=self.title, + version=self.version, + openapi_version=self.openapi_version, + summary=self.summary, + description=self.description, + terms_of_service=self.terms_of_service, + contact=self.contact, + license_info=self.license_info, + routes=self.routes, + webhooks=self.webhooks.routes, + tags=self.openapi_tags, + servers=self.servers, + separate_input_output_schemas=self.separate_input_output_schemas, + ) + return self.openapi_schema + + def setup(self) -> None: + if self.openapi_url: + urls = (server_data.get("url") for server_data in self.servers) + server_urls = {url for url in urls if url} + + async def openapi(req: Request) -> JSONResponse: + root_path = req.scope.get("root_path", "").rstrip("/") + if root_path not in server_urls: + if root_path and self.root_path_in_servers: + self.servers.insert(0, {"url": root_path}) + server_urls.add(root_path) + return JSONResponse(self.openapi()) + + self.add_route(self.openapi_url, openapi, include_in_schema=False) + if self.openapi_url and self.docs_url: + + async def swagger_ui_html(req: Request) -> HTMLResponse: + root_path = req.scope.get("root_path", "").rstrip("/") + openapi_url = root_path + self.openapi_url + oauth2_redirect_url = self.swagger_ui_oauth2_redirect_url + if oauth2_redirect_url: + oauth2_redirect_url = root_path + oauth2_redirect_url + return get_swagger_ui_html( + openapi_url=openapi_url, + title=f"{self.title} - Swagger UI", + oauth2_redirect_url=oauth2_redirect_url, + init_oauth=self.swagger_ui_init_oauth, + swagger_ui_parameters=self.swagger_ui_parameters, + ) + + self.add_route(self.docs_url, swagger_ui_html, include_in_schema=False) + + if self.swagger_ui_oauth2_redirect_url: + + async def swagger_ui_redirect(req: Request) -> HTMLResponse: + return get_swagger_ui_oauth2_redirect_html() + + self.add_route( + self.swagger_ui_oauth2_redirect_url, + swagger_ui_redirect, + include_in_schema=False, + ) + if self.openapi_url and self.redoc_url: + + async def redoc_html(req: Request) -> HTMLResponse: + root_path = req.scope.get("root_path", "").rstrip("/") + openapi_url = root_path + self.openapi_url + return get_redoc_html( + openapi_url=openapi_url, title=f"{self.title} - ReDoc" + ) + + self.add_route(self.redoc_url, redoc_html, include_in_schema=False) + + async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None: + if self.root_path: + scope["root_path"] = self.root_path + await super().__call__(scope, receive, send) + + def add_api_route( + self, + path: str, + endpoint: Callable[..., Any], + *, + response_model: Any = Default(None), + status_code: Optional[int] = None, + tags: Optional[List[Union[str, Enum]]] = None, + dependencies: Optional[Sequence[Depends]] = None, + summary: Optional[str] = None, + description: Optional[str] = None, + response_description: str = "Successful Response", + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + deprecated: Optional[bool] = None, + methods: Optional[List[str]] = None, + operation_id: Optional[str] = None, + response_model_include: Optional[IncEx] = None, + response_model_exclude: Optional[IncEx] = None, + response_model_by_alias: bool = True, + response_model_exclude_unset: bool = False, + response_model_exclude_defaults: bool = False, + response_model_exclude_none: bool = False, + include_in_schema: bool = True, + response_class: Union[Type[Response], DefaultPlaceholder] = Default( + JSONResponse + ), + name: Optional[str] = None, + openapi_extra: Optional[Dict[str, Any]] = None, + generate_unique_id_function: Callable[[routing.APIRoute], str] = Default( + generate_unique_id + ), + ) -> None: + self.router.add_api_route( + path, + endpoint=endpoint, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=methods, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def api_route( + self, + path: str, + *, + response_model: Any = Default(None), + status_code: Optional[int] = None, + tags: Optional[List[Union[str, Enum]]] = None, + dependencies: Optional[Sequence[Depends]] = None, + summary: Optional[str] = None, + description: Optional[str] = None, + response_description: str = "Successful Response", + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + deprecated: Optional[bool] = None, + methods: Optional[List[str]] = None, + operation_id: Optional[str] = None, + response_model_include: Optional[IncEx] = None, + response_model_exclude: Optional[IncEx] = None, + response_model_by_alias: bool = True, + response_model_exclude_unset: bool = False, + response_model_exclude_defaults: bool = False, + response_model_exclude_none: bool = False, + include_in_schema: bool = True, + response_class: Type[Response] = Default(JSONResponse), + name: Optional[str] = None, + openapi_extra: Optional[Dict[str, Any]] = None, + generate_unique_id_function: Callable[[routing.APIRoute], str] = Default( + generate_unique_id + ), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.router.add_api_route( + path, + func, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=methods, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + return func + + return decorator + + def add_api_websocket_route( + self, + path: str, + endpoint: Callable[..., Any], + name: Optional[str] = None, + *, + dependencies: Optional[Sequence[Depends]] = None, + ) -> None: + self.router.add_api_websocket_route( + path, + endpoint, + name=name, + dependencies=dependencies, + ) + + def websocket( + self, + path: Annotated[ + str, + Doc( + """ + WebSocket path. + """ + ), + ], + name: Annotated[ + Optional[str], + Doc( + """ + A name for the WebSocket. Only used internally. + """ + ), + ] = None, + *, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be used for this + WebSocket. + + Read more about it in the + [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/). + """ + ), + ] = None, + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Decorate a WebSocket function. + + Read more about it in the + [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/). + + **Example** + + ```python + from fastapi import FastAPI, WebSocket + + app = FastAPI() + + @app.websocket("/ws") + async def websocket_endpoint(websocket: WebSocket): + await websocket.accept() + while True: + data = await websocket.receive_text() + await websocket.send_text(f"Message text was: {data}") + ``` + """ + + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_api_websocket_route( + path, + func, + name=name, + dependencies=dependencies, + ) + return func + + return decorator + + def include_router( + self, + router: Annotated[routing.APIRouter, Doc("The `APIRouter` to include.")], + *, + prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "", + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to all the *path operations* in this + router. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to all the + *path operations* in this router. + + Read more about it in the + [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + + **Example** + + ```python + from fastapi import Depends, FastAPI + + from .dependencies import get_token_header + from .internal import admin + + app = FastAPI() + + app.include_router( + admin.router, + dependencies=[Depends(get_token_header)], + ) + ``` + """ + ), + ] = None, + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses to be shown in OpenAPI. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/). + + And in the + [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark all the *path operations* in this router as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + **Example** + + ```python + from fastapi import FastAPI + + from .internal import old_api + + app = FastAPI() + + app.include_router( + old_api.router, + deprecated=True, + ) + ``` + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include (or not) all the *path operations* in this router in the + generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + **Example** + + ```python + from fastapi import FastAPI + + from .internal import old_api + + app = FastAPI() + + app.include_router( + old_api.router, + include_in_schema=False, + ) + ``` + """ + ), + ] = True, + default_response_class: Annotated[ + Type[Response], + Doc( + """ + Default response class to be used for the *path operations* in this + router. + + Read more in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class). + + **Example** + + ```python + from fastapi import FastAPI + from fastapi.responses import ORJSONResponse + + from .internal import old_api + + app = FastAPI() + + app.include_router( + old_api.router, + default_response_class=ORJSONResponse, + ) + ``` + """ + ), + ] = Default(JSONResponse), + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> None: + """ + Include an `APIRouter` in the same app. + + Read more about it in the + [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/). + + ## Example + + ```python + from fastapi import FastAPI + + from .users import users_router + + app = FastAPI() + + app.include_router(users_router) + ``` + """ + self.router.include_router( + router, + prefix=prefix, + tags=tags, + dependencies=dependencies, + responses=responses, + deprecated=deprecated, + include_in_schema=include_in_schema, + default_response_class=default_response_class, + callbacks=callbacks, + generate_unique_id_function=generate_unique_id_function, + ) + + def get( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP GET operation. + + ## Example + + ```python + from fastapi import FastAPI + + app = FastAPI() + + @app.get("/items/") + def read_items(): + return [{"name": "Empanada"}, {"name": "Arepa"}] + ``` + """ + return self.router.get( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def put( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP PUT operation. + + ## Example + + ```python + from fastapi import FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + + @app.put("/items/{item_id}") + def replace_item(item_id: str, item: Item): + return {"message": "Item replaced", "id": item_id} + ``` + """ + return self.router.put( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def post( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP POST operation. + + ## Example + + ```python + from fastapi import FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + + @app.post("/items/") + def create_item(item: Item): + return {"message": "Item created"} + ``` + """ + return self.router.post( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def delete( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP DELETE operation. + + ## Example + + ```python + from fastapi import FastAPI + + app = FastAPI() + + @app.delete("/items/{item_id}") + def delete_item(item_id: str): + return {"message": "Item deleted"} + ``` + """ + return self.router.delete( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def options( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP OPTIONS operation. + + ## Example + + ```python + from fastapi import FastAPI + + app = FastAPI() + + @app.options("/items/") + def get_item_options(): + return {"additions": ["Aji", "Guacamole"]} + ``` + """ + return self.router.options( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def head( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP HEAD operation. + + ## Example + + ```python + from fastapi import FastAPI, Response + + app = FastAPI() + + @app.head("/items/", status_code=204) + def get_items_headers(response: Response): + response.headers["X-Cat-Dog"] = "Alone in the world" + ``` + """ + return self.router.head( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def patch( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP PATCH operation. + + ## Example + + ```python + from fastapi import FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + + @app.patch("/items/") + def update_item(item: Item): + return {"message": "Item updated in place"} + ``` + """ + return self.router.patch( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def trace( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[routing.APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP TRACE operation. + + ## Example + + ```python + from fastapi import FastAPI + + app = FastAPI() + + @app.put("/items/{item_id}") + def trace_item(item_id: str): + return None + ``` + """ + return self.router.trace( + path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def websocket_route( + self, path: str, name: Union[str, None] = None + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.router.add_websocket_route(path, func, name=name) + return func + + return decorator + + @deprecated( + """ + on_event is deprecated, use lifespan event handlers instead. + + Read more about it in the + [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/). + """ + ) + def on_event( + self, + event_type: Annotated[ + str, + Doc( + """ + The type of event. `startup` or `shutdown`. + """ + ), + ], + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add an event handler for the application. + + `on_event` is deprecated, use `lifespan` event handlers instead. + + Read more about it in the + [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/#alternative-events-deprecated). + """ + return self.router.on_event(event_type) + + def middleware( + self, + middleware_type: Annotated[ + str, + Doc( + """ + The type of middleware. Currently only supports `http`. + """ + ), + ], + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a middleware to the application. + + Read more about it in the + [FastAPI docs for Middleware](https://fastapi.tiangolo.com/tutorial/middleware/). + + ## Example + + ```python + import time + + from fastapi import FastAPI, Request + + app = FastAPI() + + + @app.middleware("http") + async def add_process_time_header(request: Request, call_next): + start_time = time.time() + response = await call_next(request) + process_time = time.time() - start_time + response.headers["X-Process-Time"] = str(process_time) + return response + ``` + """ + + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_middleware(BaseHTTPMiddleware, dispatch=func) + return func + + return decorator + + def exception_handler( + self, + exc_class_or_status_code: Annotated[ + Union[int, Type[Exception]], + Doc( + """ + The Exception class this would handle, or a status code. + """ + ), + ], + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add an exception handler to the app. + + Read more about it in the + [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/). + + ## Example + + ```python + from fastapi import FastAPI, Request + from fastapi.responses import JSONResponse + + + class UnicornException(Exception): + def __init__(self, name: str): + self.name = name + + + app = FastAPI() + + + @app.exception_handler(UnicornException) + async def unicorn_exception_handler(request: Request, exc: UnicornException): + return JSONResponse( + status_code=418, + content={"message": f"Oops! {exc.name} did something. There goes a rainbow..."}, + ) + ``` + """ + + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_exception_handler(exc_class_or_status_code, func) + return func + + return decorator diff --git a/.venv/Lib/site-packages/fastapi/background.py b/.venv/Lib/site-packages/fastapi/background.py new file mode 100644 index 0000000..203578a --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/background.py @@ -0,0 +1,59 @@ +from typing import Any, Callable + +from starlette.background import BackgroundTasks as StarletteBackgroundTasks +from typing_extensions import Annotated, Doc, ParamSpec + +P = ParamSpec("P") + + +class BackgroundTasks(StarletteBackgroundTasks): + """ + A collection of background tasks that will be called after a response has been + sent to the client. + + Read more about it in the + [FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/). + + ## Example + + ```python + from fastapi import BackgroundTasks, FastAPI + + app = FastAPI() + + + def write_notification(email: str, message=""): + with open("log.txt", mode="w") as email_file: + content = f"notification for {email}: {message}" + email_file.write(content) + + + @app.post("/send-notification/{email}") + async def send_notification(email: str, background_tasks: BackgroundTasks): + background_tasks.add_task(write_notification, email, message="some notification") + return {"message": "Notification sent in the background"} + ``` + """ + + def add_task( + self, + func: Annotated[ + Callable[P, Any], + Doc( + """ + The function to call after the response is sent. + + It can be a regular `def` function or an `async def` function. + """ + ), + ], + *args: P.args, + **kwargs: P.kwargs, + ) -> None: + """ + Add a function to be called in the background after the response is sent. + + Read more about it in the + [FastAPI docs for Background Tasks](https://fastapi.tiangolo.com/tutorial/background-tasks/). + """ + return super().add_task(func, *args, **kwargs) diff --git a/.venv/Lib/site-packages/fastapi/cli.py b/.venv/Lib/site-packages/fastapi/cli.py new file mode 100644 index 0000000..8d3301e --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/cli.py @@ -0,0 +1,13 @@ +try: + from fastapi_cli.cli import main as cli_main + +except ImportError: # pragma: no cover + cli_main = None # type: ignore + + +def main() -> None: + if not cli_main: # type: ignore[truthy-function] + message = 'To use the fastapi command, please install "fastapi[standard]":\n\n\tpip install "fastapi[standard]"\n' + print(message) + raise RuntimeError(message) # noqa: B904 + cli_main() diff --git a/.venv/Lib/site-packages/fastapi/concurrency.py b/.venv/Lib/site-packages/fastapi/concurrency.py new file mode 100644 index 0000000..3202c70 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/concurrency.py @@ -0,0 +1,39 @@ +from contextlib import asynccontextmanager as asynccontextmanager +from typing import AsyncGenerator, ContextManager, TypeVar + +import anyio.to_thread +from anyio import CapacityLimiter +from starlette.concurrency import iterate_in_threadpool as iterate_in_threadpool # noqa +from starlette.concurrency import run_in_threadpool as run_in_threadpool # noqa +from starlette.concurrency import ( # noqa + run_until_first_complete as run_until_first_complete, +) + +_T = TypeVar("_T") + + +@asynccontextmanager +async def contextmanager_in_threadpool( + cm: ContextManager[_T], +) -> AsyncGenerator[_T, None]: + # blocking __exit__ from running waiting on a free thread + # can create race conditions/deadlocks if the context manager itself + # has its own internal pool (e.g. a database connection pool) + # to avoid this we let __exit__ run without a capacity limit + # since we're creating a new limiter for each call, any non-zero limit + # works (1 is arbitrary) + exit_limiter = CapacityLimiter(1) + try: + yield await run_in_threadpool(cm.__enter__) + except Exception as e: + ok = bool( + await anyio.to_thread.run_sync( + cm.__exit__, type(e), e, e.__traceback__, limiter=exit_limiter + ) + ) + if not ok: + raise e + else: + await anyio.to_thread.run_sync( + cm.__exit__, None, None, None, limiter=exit_limiter + ) diff --git a/.venv/Lib/site-packages/fastapi/datastructures.py b/.venv/Lib/site-packages/fastapi/datastructures.py new file mode 100644 index 0000000..cf8406b --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/datastructures.py @@ -0,0 +1,204 @@ +from typing import ( + Any, + BinaryIO, + Callable, + Dict, + Iterable, + Optional, + Type, + TypeVar, + cast, +) + +from fastapi._compat import ( + PYDANTIC_V2, + CoreSchema, + GetJsonSchemaHandler, + JsonSchemaValue, + with_info_plain_validator_function, +) +from starlette.datastructures import URL as URL # noqa: F401 +from starlette.datastructures import Address as Address # noqa: F401 +from starlette.datastructures import FormData as FormData # noqa: F401 +from starlette.datastructures import Headers as Headers # noqa: F401 +from starlette.datastructures import QueryParams as QueryParams # noqa: F401 +from starlette.datastructures import State as State # noqa: F401 +from starlette.datastructures import UploadFile as StarletteUploadFile +from typing_extensions import Annotated, Doc + + +class UploadFile(StarletteUploadFile): + """ + A file uploaded in a request. + + Define it as a *path operation function* (or dependency) parameter. + + If you are using a regular `def` function, you can use the `upload_file.file` + attribute to access the raw standard Python file (blocking, not async), useful and + needed for non-async code. + + Read more about it in the + [FastAPI docs for Request Files](https://fastapi.tiangolo.com/tutorial/request-files/). + + ## Example + + ```python + from typing import Annotated + + from fastapi import FastAPI, File, UploadFile + + app = FastAPI() + + + @app.post("/files/") + async def create_file(file: Annotated[bytes, File()]): + return {"file_size": len(file)} + + + @app.post("/uploadfile/") + async def create_upload_file(file: UploadFile): + return {"filename": file.filename} + ``` + """ + + file: Annotated[ + BinaryIO, + Doc("The standard Python file object (non-async)."), + ] + filename: Annotated[Optional[str], Doc("The original file name.")] + size: Annotated[Optional[int], Doc("The size of the file in bytes.")] + headers: Annotated[Headers, Doc("The headers of the request.")] + content_type: Annotated[ + Optional[str], Doc("The content type of the request, from the headers.") + ] + + async def write( + self, + data: Annotated[ + bytes, + Doc( + """ + The bytes to write to the file. + """ + ), + ], + ) -> None: + """ + Write some bytes to the file. + + You normally wouldn't use this from a file you read in a request. + + To be awaitable, compatible with async, this is run in threadpool. + """ + return await super().write(data) + + async def read( + self, + size: Annotated[ + int, + Doc( + """ + The number of bytes to read from the file. + """ + ), + ] = -1, + ) -> bytes: + """ + Read some bytes from the file. + + To be awaitable, compatible with async, this is run in threadpool. + """ + return await super().read(size) + + async def seek( + self, + offset: Annotated[ + int, + Doc( + """ + The position in bytes to seek to in the file. + """ + ), + ], + ) -> None: + """ + Move to a position in the file. + + Any next read or write will be done from that position. + + To be awaitable, compatible with async, this is run in threadpool. + """ + return await super().seek(offset) + + async def close(self) -> None: + """ + Close the file. + + To be awaitable, compatible with async, this is run in threadpool. + """ + return await super().close() + + @classmethod + def __get_validators__(cls: Type["UploadFile"]) -> Iterable[Callable[..., Any]]: + yield cls.validate + + @classmethod + def validate(cls: Type["UploadFile"], v: Any) -> Any: + if not isinstance(v, StarletteUploadFile): + raise ValueError(f"Expected UploadFile, received: {type(v)}") + return v + + @classmethod + def _validate(cls, __input_value: Any, _: Any) -> "UploadFile": + if not isinstance(__input_value, StarletteUploadFile): + raise ValueError(f"Expected UploadFile, received: {type(__input_value)}") + return cast(UploadFile, __input_value) + + if not PYDANTIC_V2: + + @classmethod + def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None: + field_schema.update({"type": "string", "format": "binary"}) + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + return {"type": "string", "format": "binary"} + + @classmethod + def __get_pydantic_core_schema__( + cls, source: Type[Any], handler: Callable[[Any], CoreSchema] + ) -> CoreSchema: + return with_info_plain_validator_function(cls._validate) + + +class DefaultPlaceholder: + """ + You shouldn't use this class directly. + + It's used internally to recognize when a default value has been overwritten, even + if the overridden default value was truthy. + """ + + def __init__(self, value: Any): + self.value = value + + def __bool__(self) -> bool: + return bool(self.value) + + def __eq__(self, o: object) -> bool: + return isinstance(o, DefaultPlaceholder) and o.value == self.value + + +DefaultType = TypeVar("DefaultType") + + +def Default(value: DefaultType) -> DefaultType: + """ + You shouldn't use this function directly. + + It's used internally to recognize when a default value has been overwritten, even + if the overridden default value was truthy. + """ + return DefaultPlaceholder(value) # type: ignore diff --git a/.venv/Lib/site-packages/fastapi/dependencies/__init__.py b/.venv/Lib/site-packages/fastapi/dependencies/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/fastapi/dependencies/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/dependencies/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..52ed54de1161d2537f67b5ea9ad1c90a6c495eb9 GIT binary patch literal 218 zcmZ9GJqp4=5QVe;fCxE;g+-#RA~v=nY3v4;H5ub-vRP&}ft5z%IaB$7EOjG j)yOj`wb4$>*tU<+s;siQz%>p1C&HUMc=v@6)c5oQ`SCvr literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/dependencies/__pycache__/models.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/dependencies/__pycache__/models.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..854d4c1347ab7801e257db73c3f97bb03feded68 GIT binary patch literal 2761 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/dependencies/models.py b/.venv/Lib/site-packages/fastapi/dependencies/models.py new file mode 100644 index 0000000..418c117 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/dependencies/models.py @@ -0,0 +1,37 @@ +from dataclasses import dataclass, field +from typing import Any, Callable, List, Optional, Sequence, Tuple + +from fastapi._compat import ModelField +from fastapi.security.base import SecurityBase + + +@dataclass +class SecurityRequirement: + security_scheme: SecurityBase + scopes: Optional[Sequence[str]] = None + + +@dataclass +class Dependant: + path_params: List[ModelField] = field(default_factory=list) + query_params: List[ModelField] = field(default_factory=list) + header_params: List[ModelField] = field(default_factory=list) + cookie_params: List[ModelField] = field(default_factory=list) + body_params: List[ModelField] = field(default_factory=list) + dependencies: List["Dependant"] = field(default_factory=list) + security_requirements: List[SecurityRequirement] = field(default_factory=list) + name: Optional[str] = None + call: Optional[Callable[..., Any]] = None + request_param_name: Optional[str] = None + websocket_param_name: Optional[str] = None + http_connection_param_name: Optional[str] = None + response_param_name: Optional[str] = None + background_tasks_param_name: Optional[str] = None + security_scopes_param_name: Optional[str] = None + security_scopes: Optional[List[str]] = None + use_cache: bool = True + path: Optional[str] = None + cache_key: Tuple[Optional[Callable[..., Any]], Tuple[str, ...]] = field(init=False) + + def __post_init__(self) -> None: + self.cache_key = (self.call, tuple(sorted(set(self.security_scopes or [])))) diff --git a/.venv/Lib/site-packages/fastapi/dependencies/utils.py b/.venv/Lib/site-packages/fastapi/dependencies/utils.py new file mode 100644 index 0000000..e2866b4 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/dependencies/utils.py @@ -0,0 +1,972 @@ +import inspect +from contextlib import AsyncExitStack, contextmanager +from copy import copy, deepcopy +from dataclasses import dataclass +from typing import ( + Any, + Callable, + Coroutine, + Dict, + ForwardRef, + List, + Mapping, + Optional, + Sequence, + Tuple, + Type, + Union, + cast, +) + +import anyio +from fastapi import params +from fastapi._compat import ( + PYDANTIC_V2, + ErrorWrapper, + ModelField, + RequiredParam, + Undefined, + _regenerate_error_with_loc, + copy_field_info, + create_body_model, + evaluate_forwardref, + field_annotation_is_scalar, + get_annotation_from_field_info, + get_cached_model_fields, + get_missing_field_error, + is_bytes_field, + is_bytes_sequence_field, + is_scalar_field, + is_scalar_sequence_field, + is_sequence_field, + is_uploadfile_or_nonable_uploadfile_annotation, + is_uploadfile_sequence_annotation, + lenient_issubclass, + sequence_types, + serialize_sequence_value, + value_is_sequence, +) +from fastapi.background import BackgroundTasks +from fastapi.concurrency import ( + asynccontextmanager, + contextmanager_in_threadpool, +) +from fastapi.dependencies.models import Dependant, SecurityRequirement +from fastapi.logger import logger +from fastapi.security.base import SecurityBase +from fastapi.security.oauth2 import OAuth2, SecurityScopes +from fastapi.security.open_id_connect_url import OpenIdConnect +from fastapi.utils import create_model_field, get_path_param_names +from pydantic import BaseModel +from pydantic.fields import FieldInfo +from starlette.background import BackgroundTasks as StarletteBackgroundTasks +from starlette.concurrency import run_in_threadpool +from starlette.datastructures import ( + FormData, + Headers, + ImmutableMultiDict, + QueryParams, + UploadFile, +) +from starlette.requests import HTTPConnection, Request +from starlette.responses import Response +from starlette.websockets import WebSocket +from typing_extensions import Annotated, get_args, get_origin + +multipart_not_installed_error = ( + 'Form data requires "python-multipart" to be installed. \n' + 'You can install "python-multipart" with: \n\n' + "pip install python-multipart\n" +) +multipart_incorrect_install_error = ( + 'Form data requires "python-multipart" to be installed. ' + 'It seems you installed "multipart" instead. \n' + 'You can remove "multipart" with: \n\n' + "pip uninstall multipart\n\n" + 'And then install "python-multipart" with: \n\n' + "pip install python-multipart\n" +) + + +def ensure_multipart_is_installed() -> None: + try: + from python_multipart import __version__ + + # Import an attribute that can be mocked/deleted in testing + assert __version__ > "0.0.12" + except (ImportError, AssertionError): + try: + # __version__ is available in both multiparts, and can be mocked + from multipart import __version__ # type: ignore[no-redef,import-untyped] + + assert __version__ + try: + # parse_options_header is only available in the right multipart + from multipart.multipart import ( # type: ignore[import-untyped] + parse_options_header, + ) + + assert parse_options_header + except ImportError: + logger.error(multipart_incorrect_install_error) + raise RuntimeError(multipart_incorrect_install_error) from None + except ImportError: + logger.error(multipart_not_installed_error) + raise RuntimeError(multipart_not_installed_error) from None + + +def get_param_sub_dependant( + *, + param_name: str, + depends: params.Depends, + path: str, + security_scopes: Optional[List[str]] = None, +) -> Dependant: + assert depends.dependency + return get_sub_dependant( + depends=depends, + dependency=depends.dependency, + path=path, + name=param_name, + security_scopes=security_scopes, + ) + + +def get_parameterless_sub_dependant(*, depends: params.Depends, path: str) -> Dependant: + assert callable( + depends.dependency + ), "A parameter-less dependency must have a callable dependency" + return get_sub_dependant(depends=depends, dependency=depends.dependency, path=path) + + +def get_sub_dependant( + *, + depends: params.Depends, + dependency: Callable[..., Any], + path: str, + name: Optional[str] = None, + security_scopes: Optional[List[str]] = None, +) -> Dependant: + security_requirement = None + security_scopes = security_scopes or [] + if isinstance(depends, params.Security): + dependency_scopes = depends.scopes + security_scopes.extend(dependency_scopes) + if isinstance(dependency, SecurityBase): + use_scopes: List[str] = [] + if isinstance(dependency, (OAuth2, OpenIdConnect)): + use_scopes = security_scopes + security_requirement = SecurityRequirement( + security_scheme=dependency, scopes=use_scopes + ) + sub_dependant = get_dependant( + path=path, + call=dependency, + name=name, + security_scopes=security_scopes, + use_cache=depends.use_cache, + ) + if security_requirement: + sub_dependant.security_requirements.append(security_requirement) + return sub_dependant + + +CacheKey = Tuple[Optional[Callable[..., Any]], Tuple[str, ...]] + + +def get_flat_dependant( + dependant: Dependant, + *, + skip_repeats: bool = False, + visited: Optional[List[CacheKey]] = None, +) -> Dependant: + if visited is None: + visited = [] + visited.append(dependant.cache_key) + + flat_dependant = Dependant( + path_params=dependant.path_params.copy(), + query_params=dependant.query_params.copy(), + header_params=dependant.header_params.copy(), + cookie_params=dependant.cookie_params.copy(), + body_params=dependant.body_params.copy(), + security_requirements=dependant.security_requirements.copy(), + use_cache=dependant.use_cache, + path=dependant.path, + ) + for sub_dependant in dependant.dependencies: + if skip_repeats and sub_dependant.cache_key in visited: + continue + flat_sub = get_flat_dependant( + sub_dependant, skip_repeats=skip_repeats, visited=visited + ) + flat_dependant.path_params.extend(flat_sub.path_params) + flat_dependant.query_params.extend(flat_sub.query_params) + flat_dependant.header_params.extend(flat_sub.header_params) + flat_dependant.cookie_params.extend(flat_sub.cookie_params) + flat_dependant.body_params.extend(flat_sub.body_params) + flat_dependant.security_requirements.extend(flat_sub.security_requirements) + return flat_dependant + + +def _get_flat_fields_from_params(fields: List[ModelField]) -> List[ModelField]: + if not fields: + return fields + first_field = fields[0] + if len(fields) == 1 and lenient_issubclass(first_field.type_, BaseModel): + fields_to_extract = get_cached_model_fields(first_field.type_) + return fields_to_extract + return fields + + +def get_flat_params(dependant: Dependant) -> List[ModelField]: + flat_dependant = get_flat_dependant(dependant, skip_repeats=True) + path_params = _get_flat_fields_from_params(flat_dependant.path_params) + query_params = _get_flat_fields_from_params(flat_dependant.query_params) + header_params = _get_flat_fields_from_params(flat_dependant.header_params) + cookie_params = _get_flat_fields_from_params(flat_dependant.cookie_params) + return path_params + query_params + header_params + cookie_params + + +def get_typed_signature(call: Callable[..., Any]) -> inspect.Signature: + signature = inspect.signature(call) + globalns = getattr(call, "__globals__", {}) + typed_params = [ + inspect.Parameter( + name=param.name, + kind=param.kind, + default=param.default, + annotation=get_typed_annotation(param.annotation, globalns), + ) + for param in signature.parameters.values() + ] + typed_signature = inspect.Signature(typed_params) + return typed_signature + + +def get_typed_annotation(annotation: Any, globalns: Dict[str, Any]) -> Any: + if isinstance(annotation, str): + annotation = ForwardRef(annotation) + annotation = evaluate_forwardref(annotation, globalns, globalns) + return annotation + + +def get_typed_return_annotation(call: Callable[..., Any]) -> Any: + signature = inspect.signature(call) + annotation = signature.return_annotation + + if annotation is inspect.Signature.empty: + return None + + globalns = getattr(call, "__globals__", {}) + return get_typed_annotation(annotation, globalns) + + +def get_dependant( + *, + path: str, + call: Callable[..., Any], + name: Optional[str] = None, + security_scopes: Optional[List[str]] = None, + use_cache: bool = True, +) -> Dependant: + path_param_names = get_path_param_names(path) + endpoint_signature = get_typed_signature(call) + signature_params = endpoint_signature.parameters + dependant = Dependant( + call=call, + name=name, + path=path, + security_scopes=security_scopes, + use_cache=use_cache, + ) + for param_name, param in signature_params.items(): + is_path_param = param_name in path_param_names + param_details = analyze_param( + param_name=param_name, + annotation=param.annotation, + value=param.default, + is_path_param=is_path_param, + ) + if param_details.depends is not None: + sub_dependant = get_param_sub_dependant( + param_name=param_name, + depends=param_details.depends, + path=path, + security_scopes=security_scopes, + ) + dependant.dependencies.append(sub_dependant) + continue + if add_non_field_param_to_dependency( + param_name=param_name, + type_annotation=param_details.type_annotation, + dependant=dependant, + ): + assert ( + param_details.field is None + ), f"Cannot specify multiple FastAPI annotations for {param_name!r}" + continue + assert param_details.field is not None + if isinstance(param_details.field.field_info, params.Body): + dependant.body_params.append(param_details.field) + else: + add_param_to_fields(field=param_details.field, dependant=dependant) + return dependant + + +def add_non_field_param_to_dependency( + *, param_name: str, type_annotation: Any, dependant: Dependant +) -> Optional[bool]: + if lenient_issubclass(type_annotation, Request): + dependant.request_param_name = param_name + return True + elif lenient_issubclass(type_annotation, WebSocket): + dependant.websocket_param_name = param_name + return True + elif lenient_issubclass(type_annotation, HTTPConnection): + dependant.http_connection_param_name = param_name + return True + elif lenient_issubclass(type_annotation, Response): + dependant.response_param_name = param_name + return True + elif lenient_issubclass(type_annotation, StarletteBackgroundTasks): + dependant.background_tasks_param_name = param_name + return True + elif lenient_issubclass(type_annotation, SecurityScopes): + dependant.security_scopes_param_name = param_name + return True + return None + + +@dataclass +class ParamDetails: + type_annotation: Any + depends: Optional[params.Depends] + field: Optional[ModelField] + + +def analyze_param( + *, + param_name: str, + annotation: Any, + value: Any, + is_path_param: bool, +) -> ParamDetails: + field_info = None + depends = None + type_annotation: Any = Any + use_annotation: Any = Any + if annotation is not inspect.Signature.empty: + use_annotation = annotation + type_annotation = annotation + # Extract Annotated info + if get_origin(use_annotation) is Annotated: + annotated_args = get_args(annotation) + type_annotation = annotated_args[0] + fastapi_annotations = [ + arg + for arg in annotated_args[1:] + if isinstance(arg, (FieldInfo, params.Depends)) + ] + fastapi_specific_annotations = [ + arg + for arg in fastapi_annotations + if isinstance(arg, (params.Param, params.Body, params.Depends)) + ] + if fastapi_specific_annotations: + fastapi_annotation: Union[FieldInfo, params.Depends, None] = ( + fastapi_specific_annotations[-1] + ) + else: + fastapi_annotation = None + # Set default for Annotated FieldInfo + if isinstance(fastapi_annotation, FieldInfo): + # Copy `field_info` because we mutate `field_info.default` below. + field_info = copy_field_info( + field_info=fastapi_annotation, annotation=use_annotation + ) + assert ( + field_info.default is Undefined or field_info.default is RequiredParam + ), ( + f"`{field_info.__class__.__name__}` default value cannot be set in" + f" `Annotated` for {param_name!r}. Set the default value with `=` instead." + ) + if value is not inspect.Signature.empty: + assert not is_path_param, "Path parameters cannot have default values" + field_info.default = value + else: + field_info.default = RequiredParam + # Get Annotated Depends + elif isinstance(fastapi_annotation, params.Depends): + depends = fastapi_annotation + # Get Depends from default value + if isinstance(value, params.Depends): + assert depends is None, ( + "Cannot specify `Depends` in `Annotated` and default value" + f" together for {param_name!r}" + ) + assert field_info is None, ( + "Cannot specify a FastAPI annotation in `Annotated` and `Depends` as a" + f" default value together for {param_name!r}" + ) + depends = value + # Get FieldInfo from default value + elif isinstance(value, FieldInfo): + assert field_info is None, ( + "Cannot specify FastAPI annotations in `Annotated` and default value" + f" together for {param_name!r}" + ) + field_info = value + if PYDANTIC_V2: + field_info.annotation = type_annotation + + # Get Depends from type annotation + if depends is not None and depends.dependency is None: + # Copy `depends` before mutating it + depends = copy(depends) + depends.dependency = type_annotation + + # Handle non-param type annotations like Request + if lenient_issubclass( + type_annotation, + ( + Request, + WebSocket, + HTTPConnection, + Response, + StarletteBackgroundTasks, + SecurityScopes, + ), + ): + assert depends is None, f"Cannot specify `Depends` for type {type_annotation!r}" + assert ( + field_info is None + ), f"Cannot specify FastAPI annotation for type {type_annotation!r}" + # Handle default assignations, neither field_info nor depends was not found in Annotated nor default value + elif field_info is None and depends is None: + default_value = value if value is not inspect.Signature.empty else RequiredParam + if is_path_param: + # We might check here that `default_value is RequiredParam`, but the fact is that the same + # parameter might sometimes be a path parameter and sometimes not. See + # `tests/test_infer_param_optionality.py` for an example. + field_info = params.Path(annotation=use_annotation) + elif is_uploadfile_or_nonable_uploadfile_annotation( + type_annotation + ) or is_uploadfile_sequence_annotation(type_annotation): + field_info = params.File(annotation=use_annotation, default=default_value) + elif not field_annotation_is_scalar(annotation=type_annotation): + field_info = params.Body(annotation=use_annotation, default=default_value) + else: + field_info = params.Query(annotation=use_annotation, default=default_value) + + field = None + # It's a field_info, not a dependency + if field_info is not None: + # Handle field_info.in_ + if is_path_param: + assert isinstance(field_info, params.Path), ( + f"Cannot use `{field_info.__class__.__name__}` for path param" + f" {param_name!r}" + ) + elif ( + isinstance(field_info, params.Param) + and getattr(field_info, "in_", None) is None + ): + field_info.in_ = params.ParamTypes.query + use_annotation_from_field_info = get_annotation_from_field_info( + use_annotation, + field_info, + param_name, + ) + if isinstance(field_info, params.Form): + ensure_multipart_is_installed() + if not field_info.alias and getattr(field_info, "convert_underscores", None): + alias = param_name.replace("_", "-") + else: + alias = field_info.alias or param_name + field_info.alias = alias + field = create_model_field( + name=param_name, + type_=use_annotation_from_field_info, + default=field_info.default, + alias=alias, + required=field_info.default in (RequiredParam, Undefined), + field_info=field_info, + ) + if is_path_param: + assert is_scalar_field( + field=field + ), "Path params must be of one of the supported types" + elif isinstance(field_info, params.Query): + assert ( + is_scalar_field(field) + or is_scalar_sequence_field(field) + or ( + lenient_issubclass(field.type_, BaseModel) + # For Pydantic v1 + and getattr(field, "shape", 1) == 1 + ) + ) + + return ParamDetails(type_annotation=type_annotation, depends=depends, field=field) + + +def add_param_to_fields(*, field: ModelField, dependant: Dependant) -> None: + field_info = field.field_info + field_info_in = getattr(field_info, "in_", None) + if field_info_in == params.ParamTypes.path: + dependant.path_params.append(field) + elif field_info_in == params.ParamTypes.query: + dependant.query_params.append(field) + elif field_info_in == params.ParamTypes.header: + dependant.header_params.append(field) + else: + assert ( + field_info_in == params.ParamTypes.cookie + ), f"non-body parameters must be in path, query, header or cookie: {field.name}" + dependant.cookie_params.append(field) + + +def is_coroutine_callable(call: Callable[..., Any]) -> bool: + if inspect.isroutine(call): + return inspect.iscoroutinefunction(call) + if inspect.isclass(call): + return False + dunder_call = getattr(call, "__call__", None) # noqa: B004 + return inspect.iscoroutinefunction(dunder_call) + + +def is_async_gen_callable(call: Callable[..., Any]) -> bool: + if inspect.isasyncgenfunction(call): + return True + dunder_call = getattr(call, "__call__", None) # noqa: B004 + return inspect.isasyncgenfunction(dunder_call) + + +def is_gen_callable(call: Callable[..., Any]) -> bool: + if inspect.isgeneratorfunction(call): + return True + dunder_call = getattr(call, "__call__", None) # noqa: B004 + return inspect.isgeneratorfunction(dunder_call) + + +async def solve_generator( + *, call: Callable[..., Any], stack: AsyncExitStack, sub_values: Dict[str, Any] +) -> Any: + if is_gen_callable(call): + cm = contextmanager_in_threadpool(contextmanager(call)(**sub_values)) + elif is_async_gen_callable(call): + cm = asynccontextmanager(call)(**sub_values) + return await stack.enter_async_context(cm) + + +@dataclass +class SolvedDependency: + values: Dict[str, Any] + errors: List[Any] + background_tasks: Optional[StarletteBackgroundTasks] + response: Response + dependency_cache: Dict[Tuple[Callable[..., Any], Tuple[str]], Any] + + +async def solve_dependencies( + *, + request: Union[Request, WebSocket], + dependant: Dependant, + body: Optional[Union[Dict[str, Any], FormData]] = None, + background_tasks: Optional[StarletteBackgroundTasks] = None, + response: Optional[Response] = None, + dependency_overrides_provider: Optional[Any] = None, + dependency_cache: Optional[Dict[Tuple[Callable[..., Any], Tuple[str]], Any]] = None, + async_exit_stack: AsyncExitStack, + embed_body_fields: bool, +) -> SolvedDependency: + values: Dict[str, Any] = {} + errors: List[Any] = [] + if response is None: + response = Response() + del response.headers["content-length"] + response.status_code = None # type: ignore + dependency_cache = dependency_cache or {} + sub_dependant: Dependant + for sub_dependant in dependant.dependencies: + sub_dependant.call = cast(Callable[..., Any], sub_dependant.call) + sub_dependant.cache_key = cast( + Tuple[Callable[..., Any], Tuple[str]], sub_dependant.cache_key + ) + call = sub_dependant.call + use_sub_dependant = sub_dependant + if ( + dependency_overrides_provider + and dependency_overrides_provider.dependency_overrides + ): + original_call = sub_dependant.call + call = getattr( + dependency_overrides_provider, "dependency_overrides", {} + ).get(original_call, original_call) + use_path: str = sub_dependant.path # type: ignore + use_sub_dependant = get_dependant( + path=use_path, + call=call, + name=sub_dependant.name, + security_scopes=sub_dependant.security_scopes, + ) + + solved_result = await solve_dependencies( + request=request, + dependant=use_sub_dependant, + body=body, + background_tasks=background_tasks, + response=response, + dependency_overrides_provider=dependency_overrides_provider, + dependency_cache=dependency_cache, + async_exit_stack=async_exit_stack, + embed_body_fields=embed_body_fields, + ) + background_tasks = solved_result.background_tasks + dependency_cache.update(solved_result.dependency_cache) + if solved_result.errors: + errors.extend(solved_result.errors) + continue + if sub_dependant.use_cache and sub_dependant.cache_key in dependency_cache: + solved = dependency_cache[sub_dependant.cache_key] + elif is_gen_callable(call) or is_async_gen_callable(call): + solved = await solve_generator( + call=call, stack=async_exit_stack, sub_values=solved_result.values + ) + elif is_coroutine_callable(call): + solved = await call(**solved_result.values) + else: + solved = await run_in_threadpool(call, **solved_result.values) + if sub_dependant.name is not None: + values[sub_dependant.name] = solved + if sub_dependant.cache_key not in dependency_cache: + dependency_cache[sub_dependant.cache_key] = solved + path_values, path_errors = request_params_to_args( + dependant.path_params, request.path_params + ) + query_values, query_errors = request_params_to_args( + dependant.query_params, request.query_params + ) + header_values, header_errors = request_params_to_args( + dependant.header_params, request.headers + ) + cookie_values, cookie_errors = request_params_to_args( + dependant.cookie_params, request.cookies + ) + values.update(path_values) + values.update(query_values) + values.update(header_values) + values.update(cookie_values) + errors += path_errors + query_errors + header_errors + cookie_errors + if dependant.body_params: + ( + body_values, + body_errors, + ) = await request_body_to_args( # body_params checked above + body_fields=dependant.body_params, + received_body=body, + embed_body_fields=embed_body_fields, + ) + values.update(body_values) + errors.extend(body_errors) + if dependant.http_connection_param_name: + values[dependant.http_connection_param_name] = request + if dependant.request_param_name and isinstance(request, Request): + values[dependant.request_param_name] = request + elif dependant.websocket_param_name and isinstance(request, WebSocket): + values[dependant.websocket_param_name] = request + if dependant.background_tasks_param_name: + if background_tasks is None: + background_tasks = BackgroundTasks() + values[dependant.background_tasks_param_name] = background_tasks + if dependant.response_param_name: + values[dependant.response_param_name] = response + if dependant.security_scopes_param_name: + values[dependant.security_scopes_param_name] = SecurityScopes( + scopes=dependant.security_scopes + ) + return SolvedDependency( + values=values, + errors=errors, + background_tasks=background_tasks, + response=response, + dependency_cache=dependency_cache, + ) + + +def _validate_value_with_model_field( + *, field: ModelField, value: Any, values: Dict[str, Any], loc: Tuple[str, ...] +) -> Tuple[Any, List[Any]]: + if value is None: + if field.required: + return None, [get_missing_field_error(loc=loc)] + else: + return deepcopy(field.default), [] + v_, errors_ = field.validate(value, values, loc=loc) + if isinstance(errors_, ErrorWrapper): + return None, [errors_] + elif isinstance(errors_, list): + new_errors = _regenerate_error_with_loc(errors=errors_, loc_prefix=()) + return None, new_errors + else: + return v_, [] + + +def _get_multidict_value( + field: ModelField, values: Mapping[str, Any], alias: Union[str, None] = None +) -> Any: + alias = alias or field.alias + if is_sequence_field(field) and isinstance(values, (ImmutableMultiDict, Headers)): + value = values.getlist(alias) + else: + value = values.get(alias, None) + if ( + value is None + or ( + isinstance(field.field_info, params.Form) + and isinstance(value, str) # For type checks + and value == "" + ) + or (is_sequence_field(field) and len(value) == 0) + ): + if field.required: + return + else: + return deepcopy(field.default) + return value + + +def request_params_to_args( + fields: Sequence[ModelField], + received_params: Union[Mapping[str, Any], QueryParams, Headers], +) -> Tuple[Dict[str, Any], List[Any]]: + values: Dict[str, Any] = {} + errors: List[Dict[str, Any]] = [] + + if not fields: + return values, errors + + first_field = fields[0] + fields_to_extract = fields + single_not_embedded_field = False + if len(fields) == 1 and lenient_issubclass(first_field.type_, BaseModel): + fields_to_extract = get_cached_model_fields(first_field.type_) + single_not_embedded_field = True + + params_to_process: Dict[str, Any] = {} + + processed_keys = set() + + for field in fields_to_extract: + alias = None + if isinstance(received_params, Headers): + # Handle fields extracted from a Pydantic Model for a header, each field + # doesn't have a FieldInfo of type Header with the default convert_underscores=True + convert_underscores = getattr(field.field_info, "convert_underscores", True) + if convert_underscores: + alias = ( + field.alias + if field.alias != field.name + else field.name.replace("_", "-") + ) + value = _get_multidict_value(field, received_params, alias=alias) + if value is not None: + params_to_process[field.name] = value + processed_keys.add(alias or field.alias) + processed_keys.add(field.name) + + for key, value in received_params.items(): + if key not in processed_keys: + params_to_process[key] = value + + if single_not_embedded_field: + field_info = first_field.field_info + assert isinstance( + field_info, params.Param + ), "Params must be subclasses of Param" + loc: Tuple[str, ...] = (field_info.in_.value,) + v_, errors_ = _validate_value_with_model_field( + field=first_field, value=params_to_process, values=values, loc=loc + ) + return {first_field.name: v_}, errors_ + + for field in fields: + value = _get_multidict_value(field, received_params) + field_info = field.field_info + assert isinstance( + field_info, params.Param + ), "Params must be subclasses of Param" + loc = (field_info.in_.value, field.alias) + v_, errors_ = _validate_value_with_model_field( + field=field, value=value, values=values, loc=loc + ) + if errors_: + errors.extend(errors_) + else: + values[field.name] = v_ + return values, errors + + +def _should_embed_body_fields(fields: List[ModelField]) -> bool: + if not fields: + return False + # More than one dependency could have the same field, it would show up as multiple + # fields but it's the same one, so count them by name + body_param_names_set = {field.name for field in fields} + # A top level field has to be a single field, not multiple + if len(body_param_names_set) > 1: + return True + first_field = fields[0] + # If it explicitly specifies it is embedded, it has to be embedded + if getattr(first_field.field_info, "embed", None): + return True + # If it's a Form (or File) field, it has to be a BaseModel to be top level + # otherwise it has to be embedded, so that the key value pair can be extracted + if isinstance(first_field.field_info, params.Form) and not lenient_issubclass( + first_field.type_, BaseModel + ): + return True + return False + + +async def _extract_form_body( + body_fields: List[ModelField], + received_body: FormData, +) -> Dict[str, Any]: + values = {} + first_field = body_fields[0] + first_field_info = first_field.field_info + + for field in body_fields: + value = _get_multidict_value(field, received_body) + if ( + isinstance(first_field_info, params.File) + and is_bytes_field(field) + and isinstance(value, UploadFile) + ): + value = await value.read() + elif ( + is_bytes_sequence_field(field) + and isinstance(first_field_info, params.File) + and value_is_sequence(value) + ): + # For types + assert isinstance(value, sequence_types) # type: ignore[arg-type] + results: List[Union[bytes, str]] = [] + + async def process_fn( + fn: Callable[[], Coroutine[Any, Any, Any]], + ) -> None: + result = await fn() + results.append(result) # noqa: B023 + + async with anyio.create_task_group() as tg: + for sub_value in value: + tg.start_soon(process_fn, sub_value.read) + value = serialize_sequence_value(field=field, value=results) + if value is not None: + values[field.alias] = value + for key, value in received_body.items(): + if key not in values: + values[key] = value + return values + + +async def request_body_to_args( + body_fields: List[ModelField], + received_body: Optional[Union[Dict[str, Any], FormData]], + embed_body_fields: bool, +) -> Tuple[Dict[str, Any], List[Dict[str, Any]]]: + values: Dict[str, Any] = {} + errors: List[Dict[str, Any]] = [] + assert body_fields, "request_body_to_args() should be called with fields" + single_not_embedded_field = len(body_fields) == 1 and not embed_body_fields + first_field = body_fields[0] + body_to_process = received_body + + fields_to_extract: List[ModelField] = body_fields + + if single_not_embedded_field and lenient_issubclass(first_field.type_, BaseModel): + fields_to_extract = get_cached_model_fields(first_field.type_) + + if isinstance(received_body, FormData): + body_to_process = await _extract_form_body(fields_to_extract, received_body) + + if single_not_embedded_field: + loc: Tuple[str, ...] = ("body",) + v_, errors_ = _validate_value_with_model_field( + field=first_field, value=body_to_process, values=values, loc=loc + ) + return {first_field.name: v_}, errors_ + for field in body_fields: + loc = ("body", field.alias) + value: Optional[Any] = None + if body_to_process is not None: + try: + value = body_to_process.get(field.alias) + # If the received body is a list, not a dict + except AttributeError: + errors.append(get_missing_field_error(loc)) + continue + v_, errors_ = _validate_value_with_model_field( + field=field, value=value, values=values, loc=loc + ) + if errors_: + errors.extend(errors_) + else: + values[field.name] = v_ + return values, errors + + +def get_body_field( + *, flat_dependant: Dependant, name: str, embed_body_fields: bool +) -> Optional[ModelField]: + """ + Get a ModelField representing the request body for a path operation, combining + all body parameters into a single field if necessary. + + Used to check if it's form data (with `isinstance(body_field, params.Form)`) + or JSON and to generate the JSON Schema for a request body. + + This is **not** used to validate/parse the request body, that's done with each + individual body parameter. + """ + if not flat_dependant.body_params: + return None + first_param = flat_dependant.body_params[0] + if not embed_body_fields: + return first_param + model_name = "Body_" + name + BodyModel = create_body_model( + fields=flat_dependant.body_params, model_name=model_name + ) + required = any(True for f in flat_dependant.body_params if f.required) + BodyFieldInfo_kwargs: Dict[str, Any] = { + "annotation": BodyModel, + "alias": "body", + } + if not required: + BodyFieldInfo_kwargs["default"] = None + if any(isinstance(f.field_info, params.File) for f in flat_dependant.body_params): + BodyFieldInfo: Type[params.Body] = params.File + elif any(isinstance(f.field_info, params.Form) for f in flat_dependant.body_params): + BodyFieldInfo = params.Form + else: + BodyFieldInfo = params.Body + + body_param_media_types = [ + f.field_info.media_type + for f in flat_dependant.body_params + if isinstance(f.field_info, params.Body) + ] + if len(set(body_param_media_types)) == 1: + BodyFieldInfo_kwargs["media_type"] = body_param_media_types[0] + final_field = create_model_field( + name="body", + type_=BodyModel, + required=required, + alias="body", + field_info=BodyFieldInfo(**BodyFieldInfo_kwargs), + ) + return final_field diff --git a/.venv/Lib/site-packages/fastapi/encoders.py b/.venv/Lib/site-packages/fastapi/encoders.py new file mode 100644 index 0000000..451ea07 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/encoders.py @@ -0,0 +1,343 @@ +import dataclasses +import datetime +from collections import defaultdict, deque +from decimal import Decimal +from enum import Enum +from ipaddress import ( + IPv4Address, + IPv4Interface, + IPv4Network, + IPv6Address, + IPv6Interface, + IPv6Network, +) +from pathlib import Path, PurePath +from re import Pattern +from types import GeneratorType +from typing import Any, Callable, Dict, List, Optional, Tuple, Type, Union +from uuid import UUID + +from fastapi.types import IncEx +from pydantic import BaseModel +from pydantic.color import Color +from pydantic.networks import AnyUrl, NameEmail +from pydantic.types import SecretBytes, SecretStr +from typing_extensions import Annotated, Doc + +from ._compat import PYDANTIC_V2, UndefinedType, Url, _model_dump + + +# Taken from Pydantic v1 as is +def isoformat(o: Union[datetime.date, datetime.time]) -> str: + return o.isoformat() + + +# Taken from Pydantic v1 as is +# TODO: pv2 should this return strings instead? +def decimal_encoder(dec_value: Decimal) -> Union[int, float]: + """ + Encodes a Decimal as int of there's no exponent, otherwise float + + This is useful when we use ConstrainedDecimal to represent Numeric(x,0) + where a integer (but not int typed) is used. Encoding this as a float + results in failed round-tripping between encode and parse. + Our Id type is a prime example of this. + + >>> decimal_encoder(Decimal("1.0")) + 1.0 + + >>> decimal_encoder(Decimal("1")) + 1 + """ + if dec_value.as_tuple().exponent >= 0: # type: ignore[operator] + return int(dec_value) + else: + return float(dec_value) + + +ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = { + bytes: lambda o: o.decode(), + Color: str, + datetime.date: isoformat, + datetime.datetime: isoformat, + datetime.time: isoformat, + datetime.timedelta: lambda td: td.total_seconds(), + Decimal: decimal_encoder, + Enum: lambda o: o.value, + frozenset: list, + deque: list, + GeneratorType: list, + IPv4Address: str, + IPv4Interface: str, + IPv4Network: str, + IPv6Address: str, + IPv6Interface: str, + IPv6Network: str, + NameEmail: str, + Path: str, + Pattern: lambda o: o.pattern, + SecretBytes: str, + SecretStr: str, + set: list, + UUID: str, + Url: str, + AnyUrl: str, +} + + +def generate_encoders_by_class_tuples( + type_encoder_map: Dict[Any, Callable[[Any], Any]], +) -> Dict[Callable[[Any], Any], Tuple[Any, ...]]: + encoders_by_class_tuples: Dict[Callable[[Any], Any], Tuple[Any, ...]] = defaultdict( + tuple + ) + for type_, encoder in type_encoder_map.items(): + encoders_by_class_tuples[encoder] += (type_,) + return encoders_by_class_tuples + + +encoders_by_class_tuples = generate_encoders_by_class_tuples(ENCODERS_BY_TYPE) + + +def jsonable_encoder( + obj: Annotated[ + Any, + Doc( + """ + The input object to convert to JSON. + """ + ), + ], + include: Annotated[ + Optional[IncEx], + Doc( + """ + Pydantic's `include` parameter, passed to Pydantic models to set the + fields to include. + """ + ), + ] = None, + exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Pydantic's `exclude` parameter, passed to Pydantic models to set the + fields to exclude. + """ + ), + ] = None, + by_alias: Annotated[ + bool, + Doc( + """ + Pydantic's `by_alias` parameter, passed to Pydantic models to define if + the output should use the alias names (when provided) or the Python + attribute names. In an API, if you set an alias, it's probably because you + want to use it in the result, so you probably want to leave this set to + `True`. + """ + ), + ] = True, + exclude_unset: Annotated[ + bool, + Doc( + """ + Pydantic's `exclude_unset` parameter, passed to Pydantic models to define + if it should exclude from the output the fields that were not explicitly + set (and that only had their default values). + """ + ), + ] = False, + exclude_defaults: Annotated[ + bool, + Doc( + """ + Pydantic's `exclude_defaults` parameter, passed to Pydantic models to define + if it should exclude from the output the fields that had the same default + value, even when they were explicitly set. + """ + ), + ] = False, + exclude_none: Annotated[ + bool, + Doc( + """ + Pydantic's `exclude_none` parameter, passed to Pydantic models to define + if it should exclude from the output any fields that have a `None` value. + """ + ), + ] = False, + custom_encoder: Annotated[ + Optional[Dict[Any, Callable[[Any], Any]]], + Doc( + """ + Pydantic's `custom_encoder` parameter, passed to Pydantic models to define + a custom encoder. + """ + ), + ] = None, + sqlalchemy_safe: Annotated[ + bool, + Doc( + """ + Exclude from the output any fields that start with the name `_sa`. + + This is mainly a hack for compatibility with SQLAlchemy objects, they + store internal SQLAlchemy-specific state in attributes named with `_sa`, + and those objects can't (and shouldn't be) serialized to JSON. + """ + ), + ] = True, +) -> Any: + """ + Convert any object to something that can be encoded in JSON. + + This is used internally by FastAPI to make sure anything you return can be + encoded as JSON before it is sent to the client. + + You can also use it yourself, for example to convert objects before saving them + in a database that supports only JSON. + + Read more about it in the + [FastAPI docs for JSON Compatible Encoder](https://fastapi.tiangolo.com/tutorial/encoder/). + """ + custom_encoder = custom_encoder or {} + if custom_encoder: + if type(obj) in custom_encoder: + return custom_encoder[type(obj)](obj) + else: + for encoder_type, encoder_instance in custom_encoder.items(): + if isinstance(obj, encoder_type): + return encoder_instance(obj) + if include is not None and not isinstance(include, (set, dict)): + include = set(include) + if exclude is not None and not isinstance(exclude, (set, dict)): + exclude = set(exclude) + if isinstance(obj, BaseModel): + # TODO: remove when deprecating Pydantic v1 + encoders: Dict[Any, Any] = {} + if not PYDANTIC_V2: + encoders = getattr(obj.__config__, "json_encoders", {}) # type: ignore[attr-defined] + if custom_encoder: + encoders.update(custom_encoder) + obj_dict = _model_dump( + obj, + mode="json", + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_none=exclude_none, + exclude_defaults=exclude_defaults, + ) + if "__root__" in obj_dict: + obj_dict = obj_dict["__root__"] + return jsonable_encoder( + obj_dict, + exclude_none=exclude_none, + exclude_defaults=exclude_defaults, + # TODO: remove when deprecating Pydantic v1 + custom_encoder=encoders, + sqlalchemy_safe=sqlalchemy_safe, + ) + if dataclasses.is_dataclass(obj): + obj_dict = dataclasses.asdict(obj) + return jsonable_encoder( + obj_dict, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + custom_encoder=custom_encoder, + sqlalchemy_safe=sqlalchemy_safe, + ) + if isinstance(obj, Enum): + return obj.value + if isinstance(obj, PurePath): + return str(obj) + if isinstance(obj, (str, int, float, type(None))): + return obj + if isinstance(obj, UndefinedType): + return None + if isinstance(obj, dict): + encoded_dict = {} + allowed_keys = set(obj.keys()) + if include is not None: + allowed_keys &= set(include) + if exclude is not None: + allowed_keys -= set(exclude) + for key, value in obj.items(): + if ( + ( + not sqlalchemy_safe + or (not isinstance(key, str)) + or (not key.startswith("_sa")) + ) + and (value is not None or not exclude_none) + and key in allowed_keys + ): + encoded_key = jsonable_encoder( + key, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_none=exclude_none, + custom_encoder=custom_encoder, + sqlalchemy_safe=sqlalchemy_safe, + ) + encoded_value = jsonable_encoder( + value, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_none=exclude_none, + custom_encoder=custom_encoder, + sqlalchemy_safe=sqlalchemy_safe, + ) + encoded_dict[encoded_key] = encoded_value + return encoded_dict + if isinstance(obj, (list, set, frozenset, GeneratorType, tuple, deque)): + encoded_list = [] + for item in obj: + encoded_list.append( + jsonable_encoder( + item, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + custom_encoder=custom_encoder, + sqlalchemy_safe=sqlalchemy_safe, + ) + ) + return encoded_list + + if type(obj) in ENCODERS_BY_TYPE: + return ENCODERS_BY_TYPE[type(obj)](obj) + for encoder, classes_tuple in encoders_by_class_tuples.items(): + if isinstance(obj, classes_tuple): + return encoder(obj) + + try: + data = dict(obj) + except Exception as e: + errors: List[Exception] = [] + errors.append(e) + try: + data = vars(obj) + except Exception as e: + errors.append(e) + raise ValueError(errors) from e + return jsonable_encoder( + data, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + custom_encoder=custom_encoder, + sqlalchemy_safe=sqlalchemy_safe, + ) diff --git a/.venv/Lib/site-packages/fastapi/exception_handlers.py b/.venv/Lib/site-packages/fastapi/exception_handlers.py new file mode 100644 index 0000000..6c2ba7f --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/exception_handlers.py @@ -0,0 +1,34 @@ +from fastapi.encoders import jsonable_encoder +from fastapi.exceptions import RequestValidationError, WebSocketRequestValidationError +from fastapi.utils import is_body_allowed_for_status_code +from fastapi.websockets import WebSocket +from starlette.exceptions import HTTPException +from starlette.requests import Request +from starlette.responses import JSONResponse, Response +from starlette.status import HTTP_422_UNPROCESSABLE_ENTITY, WS_1008_POLICY_VIOLATION + + +async def http_exception_handler(request: Request, exc: HTTPException) -> Response: + headers = getattr(exc, "headers", None) + if not is_body_allowed_for_status_code(exc.status_code): + return Response(status_code=exc.status_code, headers=headers) + return JSONResponse( + {"detail": exc.detail}, status_code=exc.status_code, headers=headers + ) + + +async def request_validation_exception_handler( + request: Request, exc: RequestValidationError +) -> JSONResponse: + return JSONResponse( + status_code=HTTP_422_UNPROCESSABLE_ENTITY, + content={"detail": jsonable_encoder(exc.errors())}, + ) + + +async def websocket_request_validation_exception_handler( + websocket: WebSocket, exc: WebSocketRequestValidationError +) -> None: + await websocket.close( + code=WS_1008_POLICY_VIOLATION, reason=jsonable_encoder(exc.errors()) + ) diff --git a/.venv/Lib/site-packages/fastapi/exceptions.py b/.venv/Lib/site-packages/fastapi/exceptions.py new file mode 100644 index 0000000..44d4ada --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/exceptions.py @@ -0,0 +1,176 @@ +from typing import Any, Dict, Optional, Sequence, Type, Union + +from pydantic import BaseModel, create_model +from starlette.exceptions import HTTPException as StarletteHTTPException +from starlette.exceptions import WebSocketException as StarletteWebSocketException +from typing_extensions import Annotated, Doc + + +class HTTPException(StarletteHTTPException): + """ + An HTTP exception you can raise in your own code to show errors to the client. + + This is for client errors, invalid authentication, invalid data, etc. Not for server + errors in your code. + + Read more about it in the + [FastAPI docs for Handling Errors](https://fastapi.tiangolo.com/tutorial/handling-errors/). + + ## Example + + ```python + from fastapi import FastAPI, HTTPException + + app = FastAPI() + + items = {"foo": "The Foo Wrestlers"} + + + @app.get("/items/{item_id}") + async def read_item(item_id: str): + if item_id not in items: + raise HTTPException(status_code=404, detail="Item not found") + return {"item": items[item_id]} + ``` + """ + + def __init__( + self, + status_code: Annotated[ + int, + Doc( + """ + HTTP status code to send to the client. + """ + ), + ], + detail: Annotated[ + Any, + Doc( + """ + Any data to be sent to the client in the `detail` key of the JSON + response. + """ + ), + ] = None, + headers: Annotated[ + Optional[Dict[str, str]], + Doc( + """ + Any headers to send to the client in the response. + """ + ), + ] = None, + ) -> None: + super().__init__(status_code=status_code, detail=detail, headers=headers) + + +class WebSocketException(StarletteWebSocketException): + """ + A WebSocket exception you can raise in your own code to show errors to the client. + + This is for client errors, invalid authentication, invalid data, etc. Not for server + errors in your code. + + Read more about it in the + [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/). + + ## Example + + ```python + from typing import Annotated + + from fastapi import ( + Cookie, + FastAPI, + WebSocket, + WebSocketException, + status, + ) + + app = FastAPI() + + @app.websocket("/items/{item_id}/ws") + async def websocket_endpoint( + *, + websocket: WebSocket, + session: Annotated[str | None, Cookie()] = None, + item_id: str, + ): + if session is None: + raise WebSocketException(code=status.WS_1008_POLICY_VIOLATION) + await websocket.accept() + while True: + data = await websocket.receive_text() + await websocket.send_text(f"Session cookie is: {session}") + await websocket.send_text(f"Message text was: {data}, for item ID: {item_id}") + ``` + """ + + def __init__( + self, + code: Annotated[ + int, + Doc( + """ + A closing code from the + [valid codes defined in the specification](https://datatracker.ietf.org/doc/html/rfc6455#section-7.4.1). + """ + ), + ], + reason: Annotated[ + Union[str, None], + Doc( + """ + The reason to close the WebSocket connection. + + It is UTF-8-encoded data. The interpretation of the reason is up to the + application, it is not specified by the WebSocket specification. + + It could contain text that could be human-readable or interpretable + by the client code, etc. + """ + ), + ] = None, + ) -> None: + super().__init__(code=code, reason=reason) + + +RequestErrorModel: Type[BaseModel] = create_model("Request") +WebSocketErrorModel: Type[BaseModel] = create_model("WebSocket") + + +class FastAPIError(RuntimeError): + """ + A generic, FastAPI-specific error. + """ + + +class ValidationException(Exception): + def __init__(self, errors: Sequence[Any]) -> None: + self._errors = errors + + def errors(self) -> Sequence[Any]: + return self._errors + + +class RequestValidationError(ValidationException): + def __init__(self, errors: Sequence[Any], *, body: Any = None) -> None: + super().__init__(errors) + self.body = body + + +class WebSocketRequestValidationError(ValidationException): + pass + + +class ResponseValidationError(ValidationException): + def __init__(self, errors: Sequence[Any], *, body: Any = None) -> None: + super().__init__(errors) + self.body = body + + def __str__(self) -> str: + message = f"{len(self._errors)} validation errors:\n" + for err in self._errors: + message += f" {err}\n" + return message diff --git a/.venv/Lib/site-packages/fastapi/logger.py b/.venv/Lib/site-packages/fastapi/logger.py new file mode 100644 index 0000000..5b2c4ad --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/logger.py @@ -0,0 +1,3 @@ +import logging + +logger = logging.getLogger("fastapi") diff --git a/.venv/Lib/site-packages/fastapi/middleware/__init__.py b/.venv/Lib/site-packages/fastapi/middleware/__init__.py new file mode 100644 index 0000000..620296d --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/middleware/__init__.py @@ -0,0 +1 @@ +from starlette.middleware import Middleware as Middleware diff --git a/.venv/Lib/site-packages/fastapi/middleware/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/middleware/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4ddfcecf38b7f53037a0f10559bef8676143d873 GIT binary patch literal 274 zcmYLDJxc>Y5Z%2434wrxf5GC4Tx=7>##ZGT8yQ$Ox8u2H_imZpB-}6YH~3rp2M5|% z*$L^aoC7}|%*=bd8Q#3iW>dj9tzMfI&-YRMBKskSVo=5 zdz0z)&85-W;-ezGDzg57gCdI|VCnvZvTlhfkEUm_P2Mk_oWLz3F({+SFjQTAugF!@ zK42XfJdGM$A*s+3*tTI<#5-5s&)s@?d<5kNR~xu63t$s)?4Km!R*ub0dfBHD3 em%i%@m&i)S>59b{Zi;4_y}zKL_%iR2q$?NX)y literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/middleware/__pycache__/gzip.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/middleware/__pycache__/gzip.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6cf74299ae3f3b0612a42b6023109563e3b34b05 GIT binary patch literal 279 zcmYLDJxc>Y5Z%242|~oyA7F7sE@>695w!8+8k;Z>Hn-!sW;eIYY$E3$@i+Ke{09fx zSlJ2btlR~o12gj;kH>qj!{M%ob6CAKH}QWYvYqS~Z1y8~7FuX&g_Bb$MVA%%XOauq z?_ErdzcN}|d{l(jMb;m1P-HO#EZv__Hc!S=9!)P|lf2)2b_}7}m6Uh&n^-}Ku literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/middleware/__pycache__/httpsredirect.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/middleware/__pycache__/httpsredirect.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ce382e52a30ba90f3212a918685e8208a96673fe GIT binary patch literal 308 zcmY*Vu}T9$5Z&1W2|~cmUa+_#m$Zu5*jT6>8XH*%o7?fSW-qtQY$6B#hu`40_y-48 zR(3+b!pc2}5eH`GJs$IT%xk~DD`FkyZzae5-jUyu8?fGs;8_@9z=;a(07N6xFJj%feLtNYt6N55 zrL7^$DsPIJrYfiUA)2%DG$?U_q(e>0)g`NGoD=Q+q*~68Mk-t3Vx=zZRIv>>@Vc1m s5?S5r7{%M+UyR|u7@2R{-bq!PrNdL|#V`Hq)$ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/middleware/__pycache__/trustedhost.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/middleware/__pycache__/trustedhost.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a92e602d8ee069d69cbf5eab92481eb0c4339063 GIT binary patch literal 302 zcmYk2u}T9$5Qca6K!OmkvA40fBA2v^*w|R8T%nCDgw5@ES+kp6X7(cIi}(yai*ImX zWn~u#SXjA-Mje=$f0*ItV_t^CU6$goe63yTZ~d?h@gp{SNjx#lG`Gz0Th3W4^6b4| z=e*m$#)cy3b5HToXl>y^AzbC6JD{l0LX1$j-$fC>&*$kJvt;qiHoep5X17dgaCGnMKS%O)D8bgY^C?cD9NM zElw>ej!Dc+DatI438+lYNG!??D9X=DO)e>pDJarSPt8j$N-W7Qipj}OFOEq9lJSWJ z1@XD1*_H+|dS$73WidXPNioHlC8@dviOJcC>8ZsrX^B7=6lCfnY}W_bu2)cbi^C>2 fKczG$)vkyG=mth0E(S3^Ff%eT-eYhpVgqsjXLVAq literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/middleware/cors.py b/.venv/Lib/site-packages/fastapi/middleware/cors.py new file mode 100644 index 0000000..8dfaad0 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/middleware/cors.py @@ -0,0 +1 @@ +from starlette.middleware.cors import CORSMiddleware as CORSMiddleware # noqa diff --git a/.venv/Lib/site-packages/fastapi/middleware/gzip.py b/.venv/Lib/site-packages/fastapi/middleware/gzip.py new file mode 100644 index 0000000..bbeb2cc --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/middleware/gzip.py @@ -0,0 +1 @@ +from starlette.middleware.gzip import GZipMiddleware as GZipMiddleware # noqa diff --git a/.venv/Lib/site-packages/fastapi/middleware/httpsredirect.py b/.venv/Lib/site-packages/fastapi/middleware/httpsredirect.py new file mode 100644 index 0000000..b7a3d8e --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/middleware/httpsredirect.py @@ -0,0 +1,3 @@ +from starlette.middleware.httpsredirect import ( # noqa + HTTPSRedirectMiddleware as HTTPSRedirectMiddleware, +) diff --git a/.venv/Lib/site-packages/fastapi/middleware/trustedhost.py b/.venv/Lib/site-packages/fastapi/middleware/trustedhost.py new file mode 100644 index 0000000..08d7e03 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/middleware/trustedhost.py @@ -0,0 +1,3 @@ +from starlette.middleware.trustedhost import ( # noqa + TrustedHostMiddleware as TrustedHostMiddleware, +) diff --git a/.venv/Lib/site-packages/fastapi/middleware/wsgi.py b/.venv/Lib/site-packages/fastapi/middleware/wsgi.py new file mode 100644 index 0000000..c4c6a79 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/middleware/wsgi.py @@ -0,0 +1 @@ +from starlette.middleware.wsgi import WSGIMiddleware as WSGIMiddleware # noqa diff --git a/.venv/Lib/site-packages/fastapi/openapi/__init__.py b/.venv/Lib/site-packages/fastapi/openapi/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/fastapi/openapi/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/openapi/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cd2533a59b5f0f43e2d27faf0e2167ea72cac4d5 GIT binary patch literal 213 zcmZ8bI|{-;5X~9|5j=*4h0#_K8(Wbyb_2^M8RM$SE;Fl;lXwQt;td2VPax^6+--d@ z@5d|VF&qvek5T$6gT4d(qwV_U7B$gWZ0`|ud}_ny>(&d{F%pB)1!;z~$q$OEl*|!x z$6#qvVvVGnAvl|oA@eMiwX(XL<}*mHSYKhIGhpp-VpV=pB{J+4J7x9MSgeCescY?| bOlke{P3R@f2POZWPZiEti+Qx);#S+A8MXH z)V<6wvoNaJMovZ2I0Hx;aDZgi22D$5VXu$m25h31Epry=00fqmUDJ(27DqHngelxH z4T&(9JOA2uVeHZA{dv`pr7l2r&+0puZDczqJ?mQLFTkk-6|}EpA=LC7AuKRsMx&J7I8uiCsLmF0^H|lMO=*K~sTR6gQBm+^=(;Y; U;9V=NihB?F)pqT%zzZt*0Y9sD7ytkO literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/openapi/__pycache__/docs.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/openapi/__pycache__/docs.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a075c183c627ec8bc9b26bc21e41eec41790d82b GIT binary patch literal 10833 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 R*}iG3n5c1lv)T^$e*m?GpGN=y literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/openapi/__pycache__/utils.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/openapi/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1bb9d84d0e388afe8f0a47f55a75f6a4601fa19b GIT binary patch literal 20340 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 F{vY(b07(D< literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/openapi/constants.py b/.venv/Lib/site-packages/fastapi/openapi/constants.py new file mode 100644 index 0000000..d724ee3 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/openapi/constants.py @@ -0,0 +1,3 @@ +METHODS_WITH_BODY = {"GET", "HEAD", "POST", "PUT", "DELETE", "PATCH"} +REF_PREFIX = "#/components/schemas/" +REF_TEMPLATE = "#/components/schemas/{model}" diff --git a/.venv/Lib/site-packages/fastapi/openapi/docs.py b/.venv/Lib/site-packages/fastapi/openapi/docs.py new file mode 100644 index 0000000..c2ec358 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/openapi/docs.py @@ -0,0 +1,344 @@ +import json +from typing import Any, Dict, Optional + +from fastapi.encoders import jsonable_encoder +from starlette.responses import HTMLResponse +from typing_extensions import Annotated, Doc + +swagger_ui_default_parameters: Annotated[ + Dict[str, Any], + Doc( + """ + Default configurations for Swagger UI. + + You can use it as a template to add any other configurations needed. + """ + ), +] = { + "dom_id": "#swagger-ui", + "layout": "BaseLayout", + "deepLinking": True, + "showExtensions": True, + "showCommonExtensions": True, +} + + +def get_swagger_ui_html( + *, + openapi_url: Annotated[ + str, + Doc( + """ + The OpenAPI URL that Swagger UI should load and use. + + This is normally done automatically by FastAPI using the default URL + `/openapi.json`. + """ + ), + ], + title: Annotated[ + str, + Doc( + """ + The HTML `` content, normally shown in the browser tab. + """ + ), + ], + swagger_js_url: Annotated[ + str, + Doc( + """ + The URL to use to load the Swagger UI JavaScript. + + It is normally set to a CDN URL. + """ + ), + ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js", + swagger_css_url: Annotated[ + str, + Doc( + """ + The URL to use to load the Swagger UI CSS. + + It is normally set to a CDN URL. + """ + ), + ] = "https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui.css", + swagger_favicon_url: Annotated[ + str, + Doc( + """ + The URL of the favicon to use. It is normally shown in the browser tab. + """ + ), + ] = "https://fastapi.tiangolo.com/img/favicon.png", + oauth2_redirect_url: Annotated[ + Optional[str], + Doc( + """ + The OAuth2 redirect URL, it is normally automatically handled by FastAPI. + """ + ), + ] = None, + init_oauth: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + A dictionary with Swagger UI OAuth2 initialization configurations. + """ + ), + ] = None, + swagger_ui_parameters: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Configuration parameters for Swagger UI. + + It defaults to [swagger_ui_default_parameters][fastapi.openapi.docs.swagger_ui_default_parameters]. + """ + ), + ] = None, +) -> HTMLResponse: + """ + Generate and return the HTML that loads Swagger UI for the interactive + API docs (normally served at `/docs`). + + You would only call this function yourself if you needed to override some parts, + for example the URLs to use to load Swagger UI's JavaScript and CSS. + + Read more about it in the + [FastAPI docs for Configure Swagger UI](https://fastapi.tiangolo.com/how-to/configure-swagger-ui/) + and the [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/). + """ + current_swagger_ui_parameters = swagger_ui_default_parameters.copy() + if swagger_ui_parameters: + current_swagger_ui_parameters.update(swagger_ui_parameters) + + html = f""" + <!DOCTYPE html> + <html> + <head> + <link type="text/css" rel="stylesheet" href="{swagger_css_url}"> + <link rel="shortcut icon" href="{swagger_favicon_url}"> + <title>{title} + + +
+
+ + + + + + """ + return HTMLResponse(html) + + +def get_redoc_html( + *, + openapi_url: Annotated[ + str, + Doc( + """ + The OpenAPI URL that ReDoc should load and use. + + This is normally done automatically by FastAPI using the default URL + `/openapi.json`. + """ + ), + ], + title: Annotated[ + str, + Doc( + """ + The HTML `` content, normally shown in the browser tab. + """ + ), + ], + redoc_js_url: Annotated[ + str, + Doc( + """ + The URL to use to load the ReDoc JavaScript. + + It is normally set to a CDN URL. + """ + ), + ] = "https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js", + redoc_favicon_url: Annotated[ + str, + Doc( + """ + The URL of the favicon to use. It is normally shown in the browser tab. + """ + ), + ] = "https://fastapi.tiangolo.com/img/favicon.png", + with_google_fonts: Annotated[ + bool, + Doc( + """ + Load and use Google Fonts. + """ + ), + ] = True, +) -> HTMLResponse: + """ + Generate and return the HTML response that loads ReDoc for the alternative + API docs (normally served at `/redoc`). + + You would only call this function yourself if you needed to override some parts, + for example the URLs to use to load ReDoc's JavaScript and CSS. + + Read more about it in the + [FastAPI docs for Custom Docs UI Static Assets (Self-Hosting)](https://fastapi.tiangolo.com/how-to/custom-docs-ui-assets/). + """ + html = f""" + <!DOCTYPE html> + <html> + <head> + <title>{title} + + + + """ + if with_google_fonts: + html += """ + + """ + html += f""" + + + + + + + + + + + """ + return HTMLResponse(html) + + +def get_swagger_ui_oauth2_redirect_html() -> HTMLResponse: + """ + Generate the HTML response with the OAuth2 redirection for Swagger UI. + + You normally don't need to use or change this. + """ + # copied from https://github.com/swagger-api/swagger-ui/blob/v4.14.0/dist/oauth2-redirect.html + html = """ + + + + Swagger UI: OAuth2 Redirect + + + + + + """ + return HTMLResponse(content=html) diff --git a/.venv/Lib/site-packages/fastapi/openapi/models.py b/.venv/Lib/site-packages/fastapi/openapi/models.py new file mode 100644 index 0000000..ed07b40 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/openapi/models.py @@ -0,0 +1,445 @@ +from enum import Enum +from typing import Any, Callable, Dict, Iterable, List, Optional, Set, Type, Union + +from fastapi._compat import ( + PYDANTIC_V2, + CoreSchema, + GetJsonSchemaHandler, + JsonSchemaValue, + _model_rebuild, + with_info_plain_validator_function, +) +from fastapi.logger import logger +from pydantic import AnyUrl, BaseModel, Field +from typing_extensions import Annotated, Literal, TypedDict +from typing_extensions import deprecated as typing_deprecated + +try: + import email_validator + + assert email_validator # make autoflake ignore the unused import + from pydantic import EmailStr +except ImportError: # pragma: no cover + + class EmailStr(str): # type: ignore + @classmethod + def __get_validators__(cls) -> Iterable[Callable[..., Any]]: + yield cls.validate + + @classmethod + def validate(cls, v: Any) -> str: + logger.warning( + "email-validator not installed, email fields will be treated as str.\n" + "To install, run: pip install email-validator" + ) + return str(v) + + @classmethod + def _validate(cls, __input_value: Any, _: Any) -> str: + logger.warning( + "email-validator not installed, email fields will be treated as str.\n" + "To install, run: pip install email-validator" + ) + return str(__input_value) + + @classmethod + def __get_pydantic_json_schema__( + cls, core_schema: CoreSchema, handler: GetJsonSchemaHandler + ) -> JsonSchemaValue: + return {"type": "string", "format": "email"} + + @classmethod + def __get_pydantic_core_schema__( + cls, source: Type[Any], handler: Callable[[Any], CoreSchema] + ) -> CoreSchema: + return with_info_plain_validator_function(cls._validate) + + +class BaseModelWithConfig(BaseModel): + if PYDANTIC_V2: + model_config = {"extra": "allow"} + + else: + + class Config: + extra = "allow" + + +class Contact(BaseModelWithConfig): + name: Optional[str] = None + url: Optional[AnyUrl] = None + email: Optional[EmailStr] = None + + +class License(BaseModelWithConfig): + name: str + identifier: Optional[str] = None + url: Optional[AnyUrl] = None + + +class Info(BaseModelWithConfig): + title: str + summary: Optional[str] = None + description: Optional[str] = None + termsOfService: Optional[str] = None + contact: Optional[Contact] = None + license: Optional[License] = None + version: str + + +class ServerVariable(BaseModelWithConfig): + enum: Annotated[Optional[List[str]], Field(min_length=1)] = None + default: str + description: Optional[str] = None + + +class Server(BaseModelWithConfig): + url: Union[AnyUrl, str] + description: Optional[str] = None + variables: Optional[Dict[str, ServerVariable]] = None + + +class Reference(BaseModel): + ref: str = Field(alias="$ref") + + +class Discriminator(BaseModel): + propertyName: str + mapping: Optional[Dict[str, str]] = None + + +class XML(BaseModelWithConfig): + name: Optional[str] = None + namespace: Optional[str] = None + prefix: Optional[str] = None + attribute: Optional[bool] = None + wrapped: Optional[bool] = None + + +class ExternalDocumentation(BaseModelWithConfig): + description: Optional[str] = None + url: AnyUrl + + +class Schema(BaseModelWithConfig): + # Ref: JSON Schema 2020-12: https://json-schema.org/draft/2020-12/json-schema-core.html#name-the-json-schema-core-vocabu + # Core Vocabulary + schema_: Optional[str] = Field(default=None, alias="$schema") + vocabulary: Optional[str] = Field(default=None, alias="$vocabulary") + id: Optional[str] = Field(default=None, alias="$id") + anchor: Optional[str] = Field(default=None, alias="$anchor") + dynamicAnchor: Optional[str] = Field(default=None, alias="$dynamicAnchor") + ref: Optional[str] = Field(default=None, alias="$ref") + dynamicRef: Optional[str] = Field(default=None, alias="$dynamicRef") + defs: Optional[Dict[str, "SchemaOrBool"]] = Field(default=None, alias="$defs") + comment: Optional[str] = Field(default=None, alias="$comment") + # Ref: JSON Schema 2020-12: https://json-schema.org/draft/2020-12/json-schema-core.html#name-a-vocabulary-for-applying-s + # A Vocabulary for Applying Subschemas + allOf: Optional[List["SchemaOrBool"]] = None + anyOf: Optional[List["SchemaOrBool"]] = None + oneOf: Optional[List["SchemaOrBool"]] = None + not_: Optional["SchemaOrBool"] = Field(default=None, alias="not") + if_: Optional["SchemaOrBool"] = Field(default=None, alias="if") + then: Optional["SchemaOrBool"] = None + else_: Optional["SchemaOrBool"] = Field(default=None, alias="else") + dependentSchemas: Optional[Dict[str, "SchemaOrBool"]] = None + prefixItems: Optional[List["SchemaOrBool"]] = None + # TODO: uncomment and remove below when deprecating Pydantic v1 + # It generales a list of schemas for tuples, before prefixItems was available + # items: Optional["SchemaOrBool"] = None + items: Optional[Union["SchemaOrBool", List["SchemaOrBool"]]] = None + contains: Optional["SchemaOrBool"] = None + properties: Optional[Dict[str, "SchemaOrBool"]] = None + patternProperties: Optional[Dict[str, "SchemaOrBool"]] = None + additionalProperties: Optional["SchemaOrBool"] = None + propertyNames: Optional["SchemaOrBool"] = None + unevaluatedItems: Optional["SchemaOrBool"] = None + unevaluatedProperties: Optional["SchemaOrBool"] = None + # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-a-vocabulary-for-structural + # A Vocabulary for Structural Validation + type: Optional[str] = None + enum: Optional[List[Any]] = None + const: Optional[Any] = None + multipleOf: Optional[float] = Field(default=None, gt=0) + maximum: Optional[float] = None + exclusiveMaximum: Optional[float] = None + minimum: Optional[float] = None + exclusiveMinimum: Optional[float] = None + maxLength: Optional[int] = Field(default=None, ge=0) + minLength: Optional[int] = Field(default=None, ge=0) + pattern: Optional[str] = None + maxItems: Optional[int] = Field(default=None, ge=0) + minItems: Optional[int] = Field(default=None, ge=0) + uniqueItems: Optional[bool] = None + maxContains: Optional[int] = Field(default=None, ge=0) + minContains: Optional[int] = Field(default=None, ge=0) + maxProperties: Optional[int] = Field(default=None, ge=0) + minProperties: Optional[int] = Field(default=None, ge=0) + required: Optional[List[str]] = None + dependentRequired: Optional[Dict[str, Set[str]]] = None + # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-vocabularies-for-semantic-c + # Vocabularies for Semantic Content With "format" + format: Optional[str] = None + # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-a-vocabulary-for-the-conten + # A Vocabulary for the Contents of String-Encoded Data + contentEncoding: Optional[str] = None + contentMediaType: Optional[str] = None + contentSchema: Optional["SchemaOrBool"] = None + # Ref: JSON Schema Validation 2020-12: https://json-schema.org/draft/2020-12/json-schema-validation.html#name-a-vocabulary-for-basic-meta + # A Vocabulary for Basic Meta-Data Annotations + title: Optional[str] = None + description: Optional[str] = None + default: Optional[Any] = None + deprecated: Optional[bool] = None + readOnly: Optional[bool] = None + writeOnly: Optional[bool] = None + examples: Optional[List[Any]] = None + # Ref: OpenAPI 3.1.0: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#schema-object + # Schema Object + discriminator: Optional[Discriminator] = None + xml: Optional[XML] = None + externalDocs: Optional[ExternalDocumentation] = None + example: Annotated[ + Optional[Any], + typing_deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = None + + +# Ref: https://json-schema.org/draft/2020-12/json-schema-core.html#name-json-schema-documents +# A JSON Schema MUST be an object or a boolean. +SchemaOrBool = Union[Schema, bool] + + +class Example(TypedDict, total=False): + summary: Optional[str] + description: Optional[str] + value: Optional[Any] + externalValue: Optional[AnyUrl] + + if PYDANTIC_V2: # type: ignore [misc] + __pydantic_config__ = {"extra": "allow"} + + else: + + class Config: + extra = "allow" + + +class ParameterInType(Enum): + query = "query" + header = "header" + path = "path" + cookie = "cookie" + + +class Encoding(BaseModelWithConfig): + contentType: Optional[str] = None + headers: Optional[Dict[str, Union["Header", Reference]]] = None + style: Optional[str] = None + explode: Optional[bool] = None + allowReserved: Optional[bool] = None + + +class MediaType(BaseModelWithConfig): + schema_: Optional[Union[Schema, Reference]] = Field(default=None, alias="schema") + example: Optional[Any] = None + examples: Optional[Dict[str, Union[Example, Reference]]] = None + encoding: Optional[Dict[str, Encoding]] = None + + +class ParameterBase(BaseModelWithConfig): + description: Optional[str] = None + required: Optional[bool] = None + deprecated: Optional[bool] = None + # Serialization rules for simple scenarios + style: Optional[str] = None + explode: Optional[bool] = None + allowReserved: Optional[bool] = None + schema_: Optional[Union[Schema, Reference]] = Field(default=None, alias="schema") + example: Optional[Any] = None + examples: Optional[Dict[str, Union[Example, Reference]]] = None + # Serialization rules for more complex scenarios + content: Optional[Dict[str, MediaType]] = None + + +class Parameter(ParameterBase): + name: str + in_: ParameterInType = Field(alias="in") + + +class Header(ParameterBase): + pass + + +class RequestBody(BaseModelWithConfig): + description: Optional[str] = None + content: Dict[str, MediaType] + required: Optional[bool] = None + + +class Link(BaseModelWithConfig): + operationRef: Optional[str] = None + operationId: Optional[str] = None + parameters: Optional[Dict[str, Union[Any, str]]] = None + requestBody: Optional[Union[Any, str]] = None + description: Optional[str] = None + server: Optional[Server] = None + + +class Response(BaseModelWithConfig): + description: str + headers: Optional[Dict[str, Union[Header, Reference]]] = None + content: Optional[Dict[str, MediaType]] = None + links: Optional[Dict[str, Union[Link, Reference]]] = None + + +class Operation(BaseModelWithConfig): + tags: Optional[List[str]] = None + summary: Optional[str] = None + description: Optional[str] = None + externalDocs: Optional[ExternalDocumentation] = None + operationId: Optional[str] = None + parameters: Optional[List[Union[Parameter, Reference]]] = None + requestBody: Optional[Union[RequestBody, Reference]] = None + # Using Any for Specification Extensions + responses: Optional[Dict[str, Union[Response, Any]]] = None + callbacks: Optional[Dict[str, Union[Dict[str, "PathItem"], Reference]]] = None + deprecated: Optional[bool] = None + security: Optional[List[Dict[str, List[str]]]] = None + servers: Optional[List[Server]] = None + + +class PathItem(BaseModelWithConfig): + ref: Optional[str] = Field(default=None, alias="$ref") + summary: Optional[str] = None + description: Optional[str] = None + get: Optional[Operation] = None + put: Optional[Operation] = None + post: Optional[Operation] = None + delete: Optional[Operation] = None + options: Optional[Operation] = None + head: Optional[Operation] = None + patch: Optional[Operation] = None + trace: Optional[Operation] = None + servers: Optional[List[Server]] = None + parameters: Optional[List[Union[Parameter, Reference]]] = None + + +class SecuritySchemeType(Enum): + apiKey = "apiKey" + http = "http" + oauth2 = "oauth2" + openIdConnect = "openIdConnect" + + +class SecurityBase(BaseModelWithConfig): + type_: SecuritySchemeType = Field(alias="type") + description: Optional[str] = None + + +class APIKeyIn(Enum): + query = "query" + header = "header" + cookie = "cookie" + + +class APIKey(SecurityBase): + type_: SecuritySchemeType = Field(default=SecuritySchemeType.apiKey, alias="type") + in_: APIKeyIn = Field(alias="in") + name: str + + +class HTTPBase(SecurityBase): + type_: SecuritySchemeType = Field(default=SecuritySchemeType.http, alias="type") + scheme: str + + +class HTTPBearer(HTTPBase): + scheme: Literal["bearer"] = "bearer" + bearerFormat: Optional[str] = None + + +class OAuthFlow(BaseModelWithConfig): + refreshUrl: Optional[str] = None + scopes: Dict[str, str] = {} + + +class OAuthFlowImplicit(OAuthFlow): + authorizationUrl: str + + +class OAuthFlowPassword(OAuthFlow): + tokenUrl: str + + +class OAuthFlowClientCredentials(OAuthFlow): + tokenUrl: str + + +class OAuthFlowAuthorizationCode(OAuthFlow): + authorizationUrl: str + tokenUrl: str + + +class OAuthFlows(BaseModelWithConfig): + implicit: Optional[OAuthFlowImplicit] = None + password: Optional[OAuthFlowPassword] = None + clientCredentials: Optional[OAuthFlowClientCredentials] = None + authorizationCode: Optional[OAuthFlowAuthorizationCode] = None + + +class OAuth2(SecurityBase): + type_: SecuritySchemeType = Field(default=SecuritySchemeType.oauth2, alias="type") + flows: OAuthFlows + + +class OpenIdConnect(SecurityBase): + type_: SecuritySchemeType = Field( + default=SecuritySchemeType.openIdConnect, alias="type" + ) + openIdConnectUrl: str + + +SecurityScheme = Union[APIKey, HTTPBase, OAuth2, OpenIdConnect, HTTPBearer] + + +class Components(BaseModelWithConfig): + schemas: Optional[Dict[str, Union[Schema, Reference]]] = None + responses: Optional[Dict[str, Union[Response, Reference]]] = None + parameters: Optional[Dict[str, Union[Parameter, Reference]]] = None + examples: Optional[Dict[str, Union[Example, Reference]]] = None + requestBodies: Optional[Dict[str, Union[RequestBody, Reference]]] = None + headers: Optional[Dict[str, Union[Header, Reference]]] = None + securitySchemes: Optional[Dict[str, Union[SecurityScheme, Reference]]] = None + links: Optional[Dict[str, Union[Link, Reference]]] = None + # Using Any for Specification Extensions + callbacks: Optional[Dict[str, Union[Dict[str, PathItem], Reference, Any]]] = None + pathItems: Optional[Dict[str, Union[PathItem, Reference]]] = None + + +class Tag(BaseModelWithConfig): + name: str + description: Optional[str] = None + externalDocs: Optional[ExternalDocumentation] = None + + +class OpenAPI(BaseModelWithConfig): + openapi: str + info: Info + jsonSchemaDialect: Optional[str] = None + servers: Optional[List[Server]] = None + # Using Any for Specification Extensions + paths: Optional[Dict[str, Union[PathItem, Any]]] = None + webhooks: Optional[Dict[str, Union[PathItem, Reference]]] = None + components: Optional[Components] = None + security: Optional[List[Dict[str, List[str]]]] = None + tags: Optional[List[Tag]] = None + externalDocs: Optional[ExternalDocumentation] = None + + +_model_rebuild(Schema) +_model_rebuild(Operation) +_model_rebuild(Encoding) diff --git a/.venv/Lib/site-packages/fastapi/openapi/utils.py b/.venv/Lib/site-packages/fastapi/openapi/utils.py new file mode 100644 index 0000000..947eca9 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/openapi/utils.py @@ -0,0 +1,548 @@ +import http.client +import inspect +import warnings +from typing import Any, Dict, List, Optional, Sequence, Set, Tuple, Type, Union, cast + +from fastapi import routing +from fastapi._compat import ( + GenerateJsonSchema, + JsonSchemaValue, + ModelField, + Undefined, + get_compat_model_name_map, + get_definitions, + get_schema_from_model_field, + lenient_issubclass, +) +from fastapi.datastructures import DefaultPlaceholder +from fastapi.dependencies.models import Dependant +from fastapi.dependencies.utils import ( + _get_flat_fields_from_params, + get_flat_dependant, + get_flat_params, +) +from fastapi.encoders import jsonable_encoder +from fastapi.openapi.constants import METHODS_WITH_BODY, REF_PREFIX, REF_TEMPLATE +from fastapi.openapi.models import OpenAPI +from fastapi.params import Body, ParamTypes +from fastapi.responses import Response +from fastapi.types import ModelNameMap +from fastapi.utils import ( + deep_dict_update, + generate_operation_id_for_path, + is_body_allowed_for_status_code, +) +from starlette.responses import JSONResponse +from starlette.routing import BaseRoute +from starlette.status import HTTP_422_UNPROCESSABLE_ENTITY +from typing_extensions import Literal + +validation_error_definition = { + "title": "ValidationError", + "type": "object", + "properties": { + "loc": { + "title": "Location", + "type": "array", + "items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, + }, + "msg": {"title": "Message", "type": "string"}, + "type": {"title": "Error Type", "type": "string"}, + }, + "required": ["loc", "msg", "type"], +} + +validation_error_response_definition = { + "title": "HTTPValidationError", + "type": "object", + "properties": { + "detail": { + "title": "Detail", + "type": "array", + "items": {"$ref": REF_PREFIX + "ValidationError"}, + } + }, +} + +status_code_ranges: Dict[str, str] = { + "1XX": "Information", + "2XX": "Success", + "3XX": "Redirection", + "4XX": "Client Error", + "5XX": "Server Error", + "DEFAULT": "Default Response", +} + + +def get_openapi_security_definitions( + flat_dependant: Dependant, +) -> Tuple[Dict[str, Any], List[Dict[str, Any]]]: + security_definitions = {} + operation_security = [] + for security_requirement in flat_dependant.security_requirements: + security_definition = jsonable_encoder( + security_requirement.security_scheme.model, + by_alias=True, + exclude_none=True, + ) + security_name = security_requirement.security_scheme.scheme_name + security_definitions[security_name] = security_definition + operation_security.append({security_name: security_requirement.scopes}) + return security_definitions, operation_security + + +def _get_openapi_operation_parameters( + *, + dependant: Dependant, + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + field_mapping: Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + separate_input_output_schemas: bool = True, +) -> List[Dict[str, Any]]: + parameters = [] + flat_dependant = get_flat_dependant(dependant, skip_repeats=True) + path_params = _get_flat_fields_from_params(flat_dependant.path_params) + query_params = _get_flat_fields_from_params(flat_dependant.query_params) + header_params = _get_flat_fields_from_params(flat_dependant.header_params) + cookie_params = _get_flat_fields_from_params(flat_dependant.cookie_params) + parameter_groups = [ + (ParamTypes.path, path_params), + (ParamTypes.query, query_params), + (ParamTypes.header, header_params), + (ParamTypes.cookie, cookie_params), + ] + for param_type, param_group in parameter_groups: + for param in param_group: + field_info = param.field_info + # field_info = cast(Param, field_info) + if not getattr(field_info, "include_in_schema", True): + continue + param_schema = get_schema_from_model_field( + field=param, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + parameter = { + "name": param.alias, + "in": param_type.value, + "required": param.required, + "schema": param_schema, + } + if field_info.description: + parameter["description"] = field_info.description + openapi_examples = getattr(field_info, "openapi_examples", None) + example = getattr(field_info, "example", None) + if openapi_examples: + parameter["examples"] = jsonable_encoder(openapi_examples) + elif example != Undefined: + parameter["example"] = jsonable_encoder(example) + if getattr(field_info, "deprecated", None): + parameter["deprecated"] = True + parameters.append(parameter) + return parameters + + +def get_openapi_operation_request_body( + *, + body_field: Optional[ModelField], + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + field_mapping: Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + separate_input_output_schemas: bool = True, +) -> Optional[Dict[str, Any]]: + if not body_field: + return None + assert isinstance(body_field, ModelField) + body_schema = get_schema_from_model_field( + field=body_field, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + field_info = cast(Body, body_field.field_info) + request_media_type = field_info.media_type + required = body_field.required + request_body_oai: Dict[str, Any] = {} + if required: + request_body_oai["required"] = required + request_media_content: Dict[str, Any] = {"schema": body_schema} + if field_info.openapi_examples: + request_media_content["examples"] = jsonable_encoder( + field_info.openapi_examples + ) + elif field_info.example != Undefined: + request_media_content["example"] = jsonable_encoder(field_info.example) + request_body_oai["content"] = {request_media_type: request_media_content} + return request_body_oai + + +def generate_operation_id( + *, route: routing.APIRoute, method: str +) -> str: # pragma: nocover + warnings.warn( + "fastapi.openapi.utils.generate_operation_id() was deprecated, " + "it is not used internally, and will be removed soon", + DeprecationWarning, + stacklevel=2, + ) + if route.operation_id: + return route.operation_id + path: str = route.path_format + return generate_operation_id_for_path(name=route.name, path=path, method=method) + + +def generate_operation_summary(*, route: routing.APIRoute, method: str) -> str: + if route.summary: + return route.summary + return route.name.replace("_", " ").title() + + +def get_openapi_operation_metadata( + *, route: routing.APIRoute, method: str, operation_ids: Set[str] +) -> Dict[str, Any]: + operation: Dict[str, Any] = {} + if route.tags: + operation["tags"] = route.tags + operation["summary"] = generate_operation_summary(route=route, method=method) + if route.description: + operation["description"] = route.description + operation_id = route.operation_id or route.unique_id + if operation_id in operation_ids: + message = ( + f"Duplicate Operation ID {operation_id} for function " + + f"{route.endpoint.__name__}" + ) + file_name = getattr(route.endpoint, "__globals__", {}).get("__file__") + if file_name: + message += f" at {file_name}" + warnings.warn(message, stacklevel=1) + operation_ids.add(operation_id) + operation["operationId"] = operation_id + if route.deprecated: + operation["deprecated"] = route.deprecated + return operation + + +def get_openapi_path( + *, + route: routing.APIRoute, + operation_ids: Set[str], + schema_generator: GenerateJsonSchema, + model_name_map: ModelNameMap, + field_mapping: Dict[ + Tuple[ModelField, Literal["validation", "serialization"]], JsonSchemaValue + ], + separate_input_output_schemas: bool = True, +) -> Tuple[Dict[str, Any], Dict[str, Any], Dict[str, Any]]: + path = {} + security_schemes: Dict[str, Any] = {} + definitions: Dict[str, Any] = {} + assert route.methods is not None, "Methods must be a list" + if isinstance(route.response_class, DefaultPlaceholder): + current_response_class: Type[Response] = route.response_class.value + else: + current_response_class = route.response_class + assert current_response_class, "A response class is needed to generate OpenAPI" + route_response_media_type: Optional[str] = current_response_class.media_type + if route.include_in_schema: + for method in route.methods: + operation = get_openapi_operation_metadata( + route=route, method=method, operation_ids=operation_ids + ) + parameters: List[Dict[str, Any]] = [] + flat_dependant = get_flat_dependant(route.dependant, skip_repeats=True) + security_definitions, operation_security = get_openapi_security_definitions( + flat_dependant=flat_dependant + ) + if operation_security: + operation.setdefault("security", []).extend(operation_security) + if security_definitions: + security_schemes.update(security_definitions) + operation_parameters = _get_openapi_operation_parameters( + dependant=route.dependant, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + parameters.extend(operation_parameters) + if parameters: + all_parameters = { + (param["in"], param["name"]): param for param in parameters + } + required_parameters = { + (param["in"], param["name"]): param + for param in parameters + if param.get("required") + } + # Make sure required definitions of the same parameter take precedence + # over non-required definitions + all_parameters.update(required_parameters) + operation["parameters"] = list(all_parameters.values()) + if method in METHODS_WITH_BODY: + request_body_oai = get_openapi_operation_request_body( + body_field=route.body_field, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + if request_body_oai: + operation["requestBody"] = request_body_oai + if route.callbacks: + callbacks = {} + for callback in route.callbacks: + if isinstance(callback, routing.APIRoute): + ( + cb_path, + cb_security_schemes, + cb_definitions, + ) = get_openapi_path( + route=callback, + operation_ids=operation_ids, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + callbacks[callback.name] = {callback.path: cb_path} + operation["callbacks"] = callbacks + if route.status_code is not None: + status_code = str(route.status_code) + else: + # It would probably make more sense for all response classes to have an + # explicit default status_code, and to extract it from them, instead of + # doing this inspection tricks, that would probably be in the future + # TODO: probably make status_code a default class attribute for all + # responses in Starlette + response_signature = inspect.signature(current_response_class.__init__) + status_code_param = response_signature.parameters.get("status_code") + if status_code_param is not None: + if isinstance(status_code_param.default, int): + status_code = str(status_code_param.default) + operation.setdefault("responses", {}).setdefault(status_code, {})[ + "description" + ] = route.response_description + if route_response_media_type and is_body_allowed_for_status_code( + route.status_code + ): + response_schema = {"type": "string"} + if lenient_issubclass(current_response_class, JSONResponse): + if route.response_field: + response_schema = get_schema_from_model_field( + field=route.response_field, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + else: + response_schema = {} + operation.setdefault("responses", {}).setdefault( + status_code, {} + ).setdefault("content", {}).setdefault(route_response_media_type, {})[ + "schema" + ] = response_schema + if route.responses: + operation_responses = operation.setdefault("responses", {}) + for ( + additional_status_code, + additional_response, + ) in route.responses.items(): + process_response = additional_response.copy() + process_response.pop("model", None) + status_code_key = str(additional_status_code).upper() + if status_code_key == "DEFAULT": + status_code_key = "default" + openapi_response = operation_responses.setdefault( + status_code_key, {} + ) + assert isinstance( + process_response, dict + ), "An additional response must be a dict" + field = route.response_fields.get(additional_status_code) + additional_field_schema: Optional[Dict[str, Any]] = None + if field: + additional_field_schema = get_schema_from_model_field( + field=field, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + media_type = route_response_media_type or "application/json" + additional_schema = ( + process_response.setdefault("content", {}) + .setdefault(media_type, {}) + .setdefault("schema", {}) + ) + deep_dict_update(additional_schema, additional_field_schema) + status_text: Optional[str] = status_code_ranges.get( + str(additional_status_code).upper() + ) or http.client.responses.get(int(additional_status_code)) + description = ( + process_response.get("description") + or openapi_response.get("description") + or status_text + or "Additional Response" + ) + deep_dict_update(openapi_response, process_response) + openapi_response["description"] = description + http422 = str(HTTP_422_UNPROCESSABLE_ENTITY) + all_route_params = get_flat_params(route.dependant) + if (all_route_params or route.body_field) and not any( + status in operation["responses"] + for status in [http422, "4XX", "default"] + ): + operation["responses"][http422] = { + "description": "Validation Error", + "content": { + "application/json": { + "schema": {"$ref": REF_PREFIX + "HTTPValidationError"} + } + }, + } + if "ValidationError" not in definitions: + definitions.update( + { + "ValidationError": validation_error_definition, + "HTTPValidationError": validation_error_response_definition, + } + ) + if route.openapi_extra: + deep_dict_update(operation, route.openapi_extra) + path[method.lower()] = operation + return path, security_schemes, definitions + + +def get_fields_from_routes( + routes: Sequence[BaseRoute], +) -> List[ModelField]: + body_fields_from_routes: List[ModelField] = [] + responses_from_routes: List[ModelField] = [] + request_fields_from_routes: List[ModelField] = [] + callback_flat_models: List[ModelField] = [] + for route in routes: + if getattr(route, "include_in_schema", None) and isinstance( + route, routing.APIRoute + ): + if route.body_field: + assert isinstance( + route.body_field, ModelField + ), "A request body must be a Pydantic Field" + body_fields_from_routes.append(route.body_field) + if route.response_field: + responses_from_routes.append(route.response_field) + if route.response_fields: + responses_from_routes.extend(route.response_fields.values()) + if route.callbacks: + callback_flat_models.extend(get_fields_from_routes(route.callbacks)) + params = get_flat_params(route.dependant) + request_fields_from_routes.extend(params) + + flat_models = callback_flat_models + list( + body_fields_from_routes + responses_from_routes + request_fields_from_routes + ) + return flat_models + + +def get_openapi( + *, + title: str, + version: str, + openapi_version: str = "3.1.0", + summary: Optional[str] = None, + description: Optional[str] = None, + routes: Sequence[BaseRoute], + webhooks: Optional[Sequence[BaseRoute]] = None, + tags: Optional[List[Dict[str, Any]]] = None, + servers: Optional[List[Dict[str, Union[str, Any]]]] = None, + terms_of_service: Optional[str] = None, + contact: Optional[Dict[str, Union[str, Any]]] = None, + license_info: Optional[Dict[str, Union[str, Any]]] = None, + separate_input_output_schemas: bool = True, +) -> Dict[str, Any]: + info: Dict[str, Any] = {"title": title, "version": version} + if summary: + info["summary"] = summary + if description: + info["description"] = description + if terms_of_service: + info["termsOfService"] = terms_of_service + if contact: + info["contact"] = contact + if license_info: + info["license"] = license_info + output: Dict[str, Any] = {"openapi": openapi_version, "info": info} + if servers: + output["servers"] = servers + components: Dict[str, Dict[str, Any]] = {} + paths: Dict[str, Dict[str, Any]] = {} + webhook_paths: Dict[str, Dict[str, Any]] = {} + operation_ids: Set[str] = set() + all_fields = get_fields_from_routes(list(routes or []) + list(webhooks or [])) + model_name_map = get_compat_model_name_map(all_fields) + schema_generator = GenerateJsonSchema(ref_template=REF_TEMPLATE) + field_mapping, definitions = get_definitions( + fields=all_fields, + schema_generator=schema_generator, + model_name_map=model_name_map, + separate_input_output_schemas=separate_input_output_schemas, + ) + for route in routes or []: + if isinstance(route, routing.APIRoute): + result = get_openapi_path( + route=route, + operation_ids=operation_ids, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + if result: + path, security_schemes, path_definitions = result + if path: + paths.setdefault(route.path_format, {}).update(path) + if security_schemes: + components.setdefault("securitySchemes", {}).update( + security_schemes + ) + if path_definitions: + definitions.update(path_definitions) + for webhook in webhooks or []: + if isinstance(webhook, routing.APIRoute): + result = get_openapi_path( + route=webhook, + operation_ids=operation_ids, + schema_generator=schema_generator, + model_name_map=model_name_map, + field_mapping=field_mapping, + separate_input_output_schemas=separate_input_output_schemas, + ) + if result: + path, security_schemes, path_definitions = result + if path: + webhook_paths.setdefault(webhook.path_format, {}).update(path) + if security_schemes: + components.setdefault("securitySchemes", {}).update( + security_schemes + ) + if path_definitions: + definitions.update(path_definitions) + if definitions: + components["schemas"] = {k: definitions[k] for k in sorted(definitions)} + if components: + output["components"] = components + output["paths"] = paths + if webhook_paths: + output["webhooks"] = webhook_paths + if tags: + output["tags"] = tags + return jsonable_encoder(OpenAPI(**output), by_alias=True, exclude_none=True) # type: ignore diff --git a/.venv/Lib/site-packages/fastapi/param_functions.py b/.venv/Lib/site-packages/fastapi/param_functions.py new file mode 100644 index 0000000..b362162 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/param_functions.py @@ -0,0 +1,2360 @@ +from typing import Any, Callable, Dict, List, Optional, Sequence, Union + +from fastapi import params +from fastapi._compat import Undefined +from fastapi.openapi.models import Example +from typing_extensions import Annotated, Doc, deprecated + +_Unset: Any = Undefined + + +def Path( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = ..., + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + """ + Declare a path parameter for a *path operation*. + + Read more about it in the + [FastAPI docs for Path Parameters and Numeric Validations](https://fastapi.tiangolo.com/tutorial/path-params-numeric-validations/). + + ```python + from typing import Annotated + + from fastapi import FastAPI, Path + + app = FastAPI() + + + @app.get("/items/{item_id}") + async def read_items( + item_id: Annotated[int, Path(title="The ID of the item to get")], + ): + return {"item_id": item_id} + ``` + """ + return params.Path( + default=default, + default_factory=default_factory, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def Query( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + """ + ), + ] = Undefined, + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + return params.Query( + default=default, + default_factory=default_factory, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def Header( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + """ + ), + ] = Undefined, + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + convert_underscores: Annotated[ + bool, + Doc( + """ + Automatically convert underscores to hyphens in the parameter field name. + + Read more about it in the + [FastAPI docs for Header Parameters](https://fastapi.tiangolo.com/tutorial/header-params/#automatic-conversion) + """ + ), + ] = True, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + return params.Header( + default=default, + default_factory=default_factory, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + convert_underscores=convert_underscores, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def Cookie( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + """ + ), + ] = Undefined, + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + return params.Cookie( + default=default, + default_factory=default_factory, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def Body( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + """ + ), + ] = Undefined, + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + embed: Annotated[ + Union[bool, None], + Doc( + """ + When `embed` is `True`, the parameter will be expected in a JSON body as a + key instead of being the JSON body itself. + + This happens automatically when more than one `Body` parameter is declared. + + Read more about it in the + [FastAPI docs for Body - Multiple Parameters](https://fastapi.tiangolo.com/tutorial/body-multiple-params/#embed-a-single-body-parameter). + """ + ), + ] = None, + media_type: Annotated[ + str, + Doc( + """ + The media type of this parameter field. Changing it would affect the + generated OpenAPI, but currently it doesn't affect the parsing of the data. + """ + ), + ] = "application/json", + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + return params.Body( + default=default, + default_factory=default_factory, + embed=embed, + media_type=media_type, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def Form( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + """ + ), + ] = Undefined, + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + media_type: Annotated[ + str, + Doc( + """ + The media type of this parameter field. Changing it would affect the + generated OpenAPI, but currently it doesn't affect the parsing of the data. + """ + ), + ] = "application/x-www-form-urlencoded", + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + return params.Form( + default=default, + default_factory=default_factory, + media_type=media_type, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def File( # noqa: N802 + default: Annotated[ + Any, + Doc( + """ + Default value if the parameter field is not set. + """ + ), + ] = Undefined, + *, + default_factory: Annotated[ + Union[Callable[[], Any], None], + Doc( + """ + A callable to generate the default value. + + This doesn't affect `Path` parameters as the value is always required. + The parameter is available only for compatibility. + """ + ), + ] = _Unset, + media_type: Annotated[ + str, + Doc( + """ + The media type of this parameter field. Changing it would affect the + generated OpenAPI, but currently it doesn't affect the parsing of the data. + """ + ), + ] = "multipart/form-data", + alias: Annotated[ + Optional[str], + Doc( + """ + An alternative name for the parameter field. + + This will be used to extract the data and for the generated OpenAPI. + It is particularly useful when you can't use the name you want because it + is a Python reserved keyword or similar. + """ + ), + ] = None, + alias_priority: Annotated[ + Union[int, None], + Doc( + """ + Priority of the alias. This affects whether an alias generator is used. + """ + ), + ] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Whitelist' validation step. The parameter field will be the single one + allowed by the alias or set of aliases defined. + """ + ), + ] = None, + serialization_alias: Annotated[ + Union[str, None], + Doc( + """ + 'Blacklist' validation step. The vanilla parameter field will be the + single one of the alias' or set of aliases' fields and all the other + fields will be ignored at serialization time. + """ + ), + ] = None, + title: Annotated[ + Optional[str], + Doc( + """ + Human-readable title. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Human-readable description. + """ + ), + ] = None, + gt: Annotated[ + Optional[float], + Doc( + """ + Greater than. If set, value must be greater than this. Only applicable to + numbers. + """ + ), + ] = None, + ge: Annotated[ + Optional[float], + Doc( + """ + Greater than or equal. If set, value must be greater than or equal to + this. Only applicable to numbers. + """ + ), + ] = None, + lt: Annotated[ + Optional[float], + Doc( + """ + Less than. If set, value must be less than this. Only applicable to numbers. + """ + ), + ] = None, + le: Annotated[ + Optional[float], + Doc( + """ + Less than or equal. If set, value must be less than or equal to this. + Only applicable to numbers. + """ + ), + ] = None, + min_length: Annotated[ + Optional[int], + Doc( + """ + Minimum length for strings. + """ + ), + ] = None, + max_length: Annotated[ + Optional[int], + Doc( + """ + Maximum length for strings. + """ + ), + ] = None, + pattern: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + ] = None, + regex: Annotated[ + Optional[str], + Doc( + """ + RegEx pattern for strings. + """ + ), + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Annotated[ + Union[str, None], + Doc( + """ + Parameter field name for discriminating the type in a tagged union. + """ + ), + ] = None, + strict: Annotated[ + Union[bool, None], + Doc( + """ + If `True`, strict validation is applied to the field. + """ + ), + ] = _Unset, + multiple_of: Annotated[ + Union[float, None], + Doc( + """ + Value must be a multiple of this. Only applicable to numbers. + """ + ), + ] = _Unset, + allow_inf_nan: Annotated[ + Union[bool, None], + Doc( + """ + Allow `inf`, `-inf`, `nan`. Only applicable to numbers. + """ + ), + ] = _Unset, + max_digits: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of allow digits for strings. + """ + ), + ] = _Unset, + decimal_places: Annotated[ + Union[int, None], + Doc( + """ + Maximum number of decimal places allowed for numbers. + """ + ), + ] = _Unset, + examples: Annotated[ + Optional[List[Any]], + Doc( + """ + Example values for this field. + """ + ), + ] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Annotated[ + Optional[Dict[str, Example]], + Doc( + """ + OpenAPI-specific examples. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Swagger UI (that provides the `/docs` interface) has better support for the + OpenAPI-specific examples than the JSON Schema `examples`, that's the main + use case for this. + + Read more about it in the + [FastAPI docs for Declare Request Example Data](https://fastapi.tiangolo.com/tutorial/schema-extra-example/#using-the-openapi_examples-parameter). + """ + ), + ] = None, + deprecated: Annotated[ + Union[deprecated, str, bool, None], + Doc( + """ + Mark this parameter field as deprecated. + + It will affect the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) this parameter field in the generated OpenAPI. + You probably don't need it, but it's available. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + json_schema_extra: Annotated[ + Union[Dict[str, Any], None], + Doc( + """ + Any additional JSON schema data. + """ + ), + ] = None, + **extra: Annotated[ + Any, + Doc( + """ + Include extra fields used by the JSON Schema. + """ + ), + deprecated( + """ + The `extra` kwargs is deprecated. Use `json_schema_extra` instead. + """ + ), + ], +) -> Any: + return params.File( + default=default, + default_factory=default_factory, + media_type=media_type, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + example=example, + examples=examples, + openapi_examples=openapi_examples, + deprecated=deprecated, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +def Depends( # noqa: N802 + dependency: Annotated[ + Optional[Callable[..., Any]], + Doc( + """ + A "dependable" callable (like a function). + + Don't call it directly, FastAPI will call it for you, just pass the object + directly. + """ + ), + ] = None, + *, + use_cache: Annotated[ + bool, + Doc( + """ + By default, after a dependency is called the first time in a request, if + the dependency is declared again for the rest of the request (for example + if the dependency is needed by several dependencies), the value will be + re-used for the rest of the request. + + Set `use_cache` to `False` to disable this behavior and ensure the + dependency is called again (if declared more than once) in the same request. + """ + ), + ] = True, +) -> Any: + """ + Declare a FastAPI dependency. + + It takes a single "dependable" callable (like a function). + + Don't call it directly, FastAPI will call it for you. + + Read more about it in the + [FastAPI docs for Dependencies](https://fastapi.tiangolo.com/tutorial/dependencies/). + + **Example** + + ```python + from typing import Annotated + + from fastapi import Depends, FastAPI + + app = FastAPI() + + + async def common_parameters(q: str | None = None, skip: int = 0, limit: int = 100): + return {"q": q, "skip": skip, "limit": limit} + + + @app.get("/items/") + async def read_items(commons: Annotated[dict, Depends(common_parameters)]): + return commons + ``` + """ + return params.Depends(dependency=dependency, use_cache=use_cache) + + +def Security( # noqa: N802 + dependency: Annotated[ + Optional[Callable[..., Any]], + Doc( + """ + A "dependable" callable (like a function). + + Don't call it directly, FastAPI will call it for you, just pass the object + directly. + """ + ), + ] = None, + *, + scopes: Annotated[ + Optional[Sequence[str]], + Doc( + """ + OAuth2 scopes required for the *path operation* that uses this Security + dependency. + + The term "scope" comes from the OAuth2 specification, it seems to be + intentionally vague and interpretable. It normally refers to permissions, + in cases to roles. + + These scopes are integrated with OpenAPI (and the API docs at `/docs`). + So they are visible in the OpenAPI specification. + ) + """ + ), + ] = None, + use_cache: Annotated[ + bool, + Doc( + """ + By default, after a dependency is called the first time in a request, if + the dependency is declared again for the rest of the request (for example + if the dependency is needed by several dependencies), the value will be + re-used for the rest of the request. + + Set `use_cache` to `False` to disable this behavior and ensure the + dependency is called again (if declared more than once) in the same request. + """ + ), + ] = True, +) -> Any: + """ + Declare a FastAPI Security dependency. + + The only difference with a regular dependency is that it can declare OAuth2 + scopes that will be integrated with OpenAPI and the automatic UI docs (by default + at `/docs`). + + It takes a single "dependable" callable (like a function). + + Don't call it directly, FastAPI will call it for you. + + Read more about it in the + [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/) and + in the + [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/). + + **Example** + + ```python + from typing import Annotated + + from fastapi import Security, FastAPI + + from .db import User + from .security import get_current_active_user + + app = FastAPI() + + @app.get("/users/me/items/") + async def read_own_items( + current_user: Annotated[User, Security(get_current_active_user, scopes=["items"])] + ): + return [{"item_id": "Foo", "owner": current_user.username}] + ``` + """ + return params.Security(dependency=dependency, scopes=scopes, use_cache=use_cache) diff --git a/.venv/Lib/site-packages/fastapi/params.py b/.venv/Lib/site-packages/fastapi/params.py new file mode 100644 index 0000000..8f5601d --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/params.py @@ -0,0 +1,786 @@ +import warnings +from enum import Enum +from typing import Any, Callable, Dict, List, Optional, Sequence, Union + +from fastapi.openapi.models import Example +from pydantic.fields import FieldInfo +from typing_extensions import Annotated, deprecated + +from ._compat import ( + PYDANTIC_V2, + PYDANTIC_VERSION_MINOR_TUPLE, + Undefined, +) + +_Unset: Any = Undefined + + +class ParamTypes(Enum): + query = "query" + header = "header" + path = "path" + cookie = "cookie" + + +class Param(FieldInfo): + in_: ParamTypes + + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + if example is not _Unset: + warnings.warn( + "`example` has been deprecated, please use `examples` instead", + category=DeprecationWarning, + stacklevel=4, + ) + self.example = example + self.include_in_schema = include_in_schema + self.openapi_examples = openapi_examples + kwargs = dict( + default=default, + default_factory=default_factory, + alias=alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + discriminator=discriminator, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + **extra, + ) + if examples is not None: + kwargs["examples"] = examples + if regex is not None: + warnings.warn( + "`regex` has been deprecated, please use `pattern` instead", + category=DeprecationWarning, + stacklevel=4, + ) + current_json_schema_extra = json_schema_extra or extra + if PYDANTIC_VERSION_MINOR_TUPLE < (2, 7): + self.deprecated = deprecated + else: + kwargs["deprecated"] = deprecated + if PYDANTIC_V2: + kwargs.update( + { + "annotation": annotation, + "alias_priority": alias_priority, + "validation_alias": validation_alias, + "serialization_alias": serialization_alias, + "strict": strict, + "json_schema_extra": current_json_schema_extra, + } + ) + kwargs["pattern"] = pattern or regex + else: + kwargs["regex"] = pattern or regex + kwargs.update(**current_json_schema_extra) + use_kwargs = {k: v for k, v in kwargs.items() if v is not _Unset} + + super().__init__(**use_kwargs) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.default})" + + +class Path(Param): + in_ = ParamTypes.path + + def __init__( + self, + default: Any = ..., + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + assert default is ..., "Path parameters cannot have a default value" + self.in_ = self.in_ + super().__init__( + default=default, + default_factory=default_factory, + annotation=annotation, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + deprecated=deprecated, + example=example, + examples=examples, + openapi_examples=openapi_examples, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +class Query(Param): + in_ = ParamTypes.query + + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + super().__init__( + default=default, + default_factory=default_factory, + annotation=annotation, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + deprecated=deprecated, + example=example, + examples=examples, + openapi_examples=openapi_examples, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +class Header(Param): + in_ = ParamTypes.header + + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + convert_underscores: bool = True, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + self.convert_underscores = convert_underscores + super().__init__( + default=default, + default_factory=default_factory, + annotation=annotation, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + deprecated=deprecated, + example=example, + examples=examples, + openapi_examples=openapi_examples, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +class Cookie(Param): + in_ = ParamTypes.cookie + + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + super().__init__( + default=default, + default_factory=default_factory, + annotation=annotation, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + deprecated=deprecated, + example=example, + examples=examples, + openapi_examples=openapi_examples, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +class Body(FieldInfo): + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + embed: Union[bool, None] = None, + media_type: str = "application/json", + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + self.embed = embed + self.media_type = media_type + if example is not _Unset: + warnings.warn( + "`example` has been deprecated, please use `examples` instead", + category=DeprecationWarning, + stacklevel=4, + ) + self.example = example + self.include_in_schema = include_in_schema + self.openapi_examples = openapi_examples + kwargs = dict( + default=default, + default_factory=default_factory, + alias=alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + discriminator=discriminator, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + **extra, + ) + if examples is not None: + kwargs["examples"] = examples + if regex is not None: + warnings.warn( + "`regex` has been deprecated, please use `pattern` instead", + category=DeprecationWarning, + stacklevel=4, + ) + current_json_schema_extra = json_schema_extra or extra + if PYDANTIC_VERSION_MINOR_TUPLE < (2, 7): + self.deprecated = deprecated + else: + kwargs["deprecated"] = deprecated + if PYDANTIC_V2: + kwargs.update( + { + "annotation": annotation, + "alias_priority": alias_priority, + "validation_alias": validation_alias, + "serialization_alias": serialization_alias, + "strict": strict, + "json_schema_extra": current_json_schema_extra, + } + ) + kwargs["pattern"] = pattern or regex + else: + kwargs["regex"] = pattern or regex + kwargs.update(**current_json_schema_extra) + + use_kwargs = {k: v for k, v in kwargs.items() if v is not _Unset} + + super().__init__(**use_kwargs) + + def __repr__(self) -> str: + return f"{self.__class__.__name__}({self.default})" + + +class Form(Body): + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + media_type: str = "application/x-www-form-urlencoded", + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + super().__init__( + default=default, + default_factory=default_factory, + annotation=annotation, + media_type=media_type, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + deprecated=deprecated, + example=example, + examples=examples, + openapi_examples=openapi_examples, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +class File(Form): + def __init__( + self, + default: Any = Undefined, + *, + default_factory: Union[Callable[[], Any], None] = _Unset, + annotation: Optional[Any] = None, + media_type: str = "multipart/form-data", + alias: Optional[str] = None, + alias_priority: Union[int, None] = _Unset, + # TODO: update when deprecating Pydantic v1, import these types + # validation_alias: str | AliasPath | AliasChoices | None + validation_alias: Union[str, None] = None, + serialization_alias: Union[str, None] = None, + title: Optional[str] = None, + description: Optional[str] = None, + gt: Optional[float] = None, + ge: Optional[float] = None, + lt: Optional[float] = None, + le: Optional[float] = None, + min_length: Optional[int] = None, + max_length: Optional[int] = None, + pattern: Optional[str] = None, + regex: Annotated[ + Optional[str], + deprecated( + "Deprecated in FastAPI 0.100.0 and Pydantic v2, use `pattern` instead." + ), + ] = None, + discriminator: Union[str, None] = None, + strict: Union[bool, None] = _Unset, + multiple_of: Union[float, None] = _Unset, + allow_inf_nan: Union[bool, None] = _Unset, + max_digits: Union[int, None] = _Unset, + decimal_places: Union[int, None] = _Unset, + examples: Optional[List[Any]] = None, + example: Annotated[ + Optional[Any], + deprecated( + "Deprecated in OpenAPI 3.1.0 that now uses JSON Schema 2020-12, " + "although still supported. Use examples instead." + ), + ] = _Unset, + openapi_examples: Optional[Dict[str, Example]] = None, + deprecated: Union[deprecated, str, bool, None] = None, + include_in_schema: bool = True, + json_schema_extra: Union[Dict[str, Any], None] = None, + **extra: Any, + ): + super().__init__( + default=default, + default_factory=default_factory, + annotation=annotation, + media_type=media_type, + alias=alias, + alias_priority=alias_priority, + validation_alias=validation_alias, + serialization_alias=serialization_alias, + title=title, + description=description, + gt=gt, + ge=ge, + lt=lt, + le=le, + min_length=min_length, + max_length=max_length, + pattern=pattern, + regex=regex, + discriminator=discriminator, + strict=strict, + multiple_of=multiple_of, + allow_inf_nan=allow_inf_nan, + max_digits=max_digits, + decimal_places=decimal_places, + deprecated=deprecated, + example=example, + examples=examples, + openapi_examples=openapi_examples, + include_in_schema=include_in_schema, + json_schema_extra=json_schema_extra, + **extra, + ) + + +class Depends: + def __init__( + self, dependency: Optional[Callable[..., Any]] = None, *, use_cache: bool = True + ): + self.dependency = dependency + self.use_cache = use_cache + + def __repr__(self) -> str: + attr = getattr(self.dependency, "__name__", type(self.dependency).__name__) + cache = "" if self.use_cache else ", use_cache=False" + return f"{self.__class__.__name__}({attr}{cache})" + + +class Security(Depends): + def __init__( + self, + dependency: Optional[Callable[..., Any]] = None, + *, + scopes: Optional[Sequence[str]] = None, + use_cache: bool = True, + ): + super().__init__(dependency=dependency, use_cache=use_cache) + self.scopes = scopes or [] diff --git a/.venv/Lib/site-packages/fastapi/py.typed b/.venv/Lib/site-packages/fastapi/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/fastapi/requests.py b/.venv/Lib/site-packages/fastapi/requests.py new file mode 100644 index 0000000..d16552c --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/requests.py @@ -0,0 +1,2 @@ +from starlette.requests import HTTPConnection as HTTPConnection # noqa: F401 +from starlette.requests import Request as Request # noqa: F401 diff --git a/.venv/Lib/site-packages/fastapi/responses.py b/.venv/Lib/site-packages/fastapi/responses.py new file mode 100644 index 0000000..6c8db6f --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/responses.py @@ -0,0 +1,48 @@ +from typing import Any + +from starlette.responses import FileResponse as FileResponse # noqa +from starlette.responses import HTMLResponse as HTMLResponse # noqa +from starlette.responses import JSONResponse as JSONResponse # noqa +from starlette.responses import PlainTextResponse as PlainTextResponse # noqa +from starlette.responses import RedirectResponse as RedirectResponse # noqa +from starlette.responses import Response as Response # noqa +from starlette.responses import StreamingResponse as StreamingResponse # noqa + +try: + import ujson +except ImportError: # pragma: nocover + ujson = None # type: ignore + + +try: + import orjson +except ImportError: # pragma: nocover + orjson = None # type: ignore + + +class UJSONResponse(JSONResponse): + """ + JSON response using the high-performance ujson library to serialize data to JSON. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/). + """ + + def render(self, content: Any) -> bytes: + assert ujson is not None, "ujson must be installed to use UJSONResponse" + return ujson.dumps(content, ensure_ascii=False).encode("utf-8") + + +class ORJSONResponse(JSONResponse): + """ + JSON response using the high-performance orjson library to serialize data to JSON. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/). + """ + + def render(self, content: Any) -> bytes: + assert orjson is not None, "orjson must be installed to use ORJSONResponse" + return orjson.dumps( + content, option=orjson.OPT_NON_STR_KEYS | orjson.OPT_SERIALIZE_NUMPY + ) diff --git a/.venv/Lib/site-packages/fastapi/routing.py b/.venv/Lib/site-packages/fastapi/routing.py new file mode 100644 index 0000000..8ea4bb2 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/routing.py @@ -0,0 +1,4439 @@ +import asyncio +import dataclasses +import email.message +import inspect +import json +from contextlib import AsyncExitStack, asynccontextmanager +from enum import Enum, IntEnum +from typing import ( + Any, + AsyncIterator, + Callable, + Coroutine, + Dict, + List, + Mapping, + Optional, + Sequence, + Set, + Tuple, + Type, + Union, +) + +from fastapi import params +from fastapi._compat import ( + ModelField, + Undefined, + _get_model_config, + _model_dump, + _normalize_errors, + lenient_issubclass, +) +from fastapi.datastructures import Default, DefaultPlaceholder +from fastapi.dependencies.models import Dependant +from fastapi.dependencies.utils import ( + _should_embed_body_fields, + get_body_field, + get_dependant, + get_flat_dependant, + get_parameterless_sub_dependant, + get_typed_return_annotation, + solve_dependencies, +) +from fastapi.encoders import jsonable_encoder +from fastapi.exceptions import ( + FastAPIError, + RequestValidationError, + ResponseValidationError, + WebSocketRequestValidationError, +) +from fastapi.types import DecoratedCallable, IncEx +from fastapi.utils import ( + create_cloned_field, + create_model_field, + generate_unique_id, + get_value_or_default, + is_body_allowed_for_status_code, +) +from pydantic import BaseModel +from starlette import routing +from starlette.concurrency import run_in_threadpool +from starlette.exceptions import HTTPException +from starlette.requests import Request +from starlette.responses import JSONResponse, Response +from starlette.routing import ( + BaseRoute, + Match, + compile_path, + get_name, + request_response, + websocket_session, +) +from starlette.routing import Mount as Mount # noqa +from starlette.types import AppType, ASGIApp, Lifespan, Scope +from starlette.websockets import WebSocket +from typing_extensions import Annotated, Doc, deprecated + + +def _prepare_response_content( + res: Any, + *, + exclude_unset: bool, + exclude_defaults: bool = False, + exclude_none: bool = False, +) -> Any: + if isinstance(res, BaseModel): + read_with_orm_mode = getattr(_get_model_config(res), "read_with_orm_mode", None) + if read_with_orm_mode: + # Let from_orm extract the data from this model instead of converting + # it now to a dict. + # Otherwise, there's no way to extract lazy data that requires attribute + # access instead of dict iteration, e.g. lazy relationships. + return res + return _model_dump( + res, + by_alias=True, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + elif isinstance(res, list): + return [ + _prepare_response_content( + item, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + for item in res + ] + elif isinstance(res, dict): + return { + k: _prepare_response_content( + v, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + for k, v in res.items() + } + elif dataclasses.is_dataclass(res): + return dataclasses.asdict(res) + return res + + +def _merge_lifespan_context( + original_context: Lifespan[Any], nested_context: Lifespan[Any] +) -> Lifespan[Any]: + @asynccontextmanager + async def merged_lifespan( + app: AppType, + ) -> AsyncIterator[Optional[Mapping[str, Any]]]: + async with original_context(app) as maybe_original_state: + async with nested_context(app) as maybe_nested_state: + if maybe_nested_state is None and maybe_original_state is None: + yield None # old ASGI compatibility + else: + yield {**(maybe_nested_state or {}), **(maybe_original_state or {})} + + return merged_lifespan # type: ignore[return-value] + + +async def serialize_response( + *, + field: Optional[ModelField] = None, + response_content: Any, + include: Optional[IncEx] = None, + exclude: Optional[IncEx] = None, + by_alias: bool = True, + exclude_unset: bool = False, + exclude_defaults: bool = False, + exclude_none: bool = False, + is_coroutine: bool = True, +) -> Any: + if field: + errors = [] + if not hasattr(field, "serialize"): + # pydantic v1 + response_content = _prepare_response_content( + response_content, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + if is_coroutine: + value, errors_ = field.validate(response_content, {}, loc=("response",)) + else: + value, errors_ = await run_in_threadpool( + field.validate, response_content, {}, loc=("response",) + ) + if isinstance(errors_, list): + errors.extend(errors_) + elif errors_: + errors.append(errors_) + if errors: + raise ResponseValidationError( + errors=_normalize_errors(errors), body=response_content + ) + + if hasattr(field, "serialize"): + return field.serialize( + value, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + + return jsonable_encoder( + value, + include=include, + exclude=exclude, + by_alias=by_alias, + exclude_unset=exclude_unset, + exclude_defaults=exclude_defaults, + exclude_none=exclude_none, + ) + else: + return jsonable_encoder(response_content) + + +async def run_endpoint_function( + *, dependant: Dependant, values: Dict[str, Any], is_coroutine: bool +) -> Any: + # Only called by get_request_handler. Has been split into its own function to + # facilitate profiling endpoints, since inner functions are harder to profile. + assert dependant.call is not None, "dependant.call must be a function" + + if is_coroutine: + return await dependant.call(**values) + else: + return await run_in_threadpool(dependant.call, **values) + + +def get_request_handler( + dependant: Dependant, + body_field: Optional[ModelField] = None, + status_code: Optional[int] = None, + response_class: Union[Type[Response], DefaultPlaceholder] = Default(JSONResponse), + response_field: Optional[ModelField] = None, + response_model_include: Optional[IncEx] = None, + response_model_exclude: Optional[IncEx] = None, + response_model_by_alias: bool = True, + response_model_exclude_unset: bool = False, + response_model_exclude_defaults: bool = False, + response_model_exclude_none: bool = False, + dependency_overrides_provider: Optional[Any] = None, + embed_body_fields: bool = False, +) -> Callable[[Request], Coroutine[Any, Any, Response]]: + assert dependant.call is not None, "dependant.call must be a function" + is_coroutine = asyncio.iscoroutinefunction(dependant.call) + is_body_form = body_field and isinstance(body_field.field_info, params.Form) + if isinstance(response_class, DefaultPlaceholder): + actual_response_class: Type[Response] = response_class.value + else: + actual_response_class = response_class + + async def app(request: Request) -> Response: + response: Union[Response, None] = None + async with AsyncExitStack() as file_stack: + try: + body: Any = None + if body_field: + if is_body_form: + body = await request.form() + file_stack.push_async_callback(body.close) + else: + body_bytes = await request.body() + if body_bytes: + json_body: Any = Undefined + content_type_value = request.headers.get("content-type") + if not content_type_value: + json_body = await request.json() + else: + message = email.message.Message() + message["content-type"] = content_type_value + if message.get_content_maintype() == "application": + subtype = message.get_content_subtype() + if subtype == "json" or subtype.endswith("+json"): + json_body = await request.json() + if json_body != Undefined: + body = json_body + else: + body = body_bytes + except json.JSONDecodeError as e: + validation_error = RequestValidationError( + [ + { + "type": "json_invalid", + "loc": ("body", e.pos), + "msg": "JSON decode error", + "input": {}, + "ctx": {"error": e.msg}, + } + ], + body=e.doc, + ) + raise validation_error from e + except HTTPException: + # If a middleware raises an HTTPException, it should be raised again + raise + except Exception as e: + http_error = HTTPException( + status_code=400, detail="There was an error parsing the body" + ) + raise http_error from e + errors: List[Any] = [] + async with AsyncExitStack() as async_exit_stack: + solved_result = await solve_dependencies( + request=request, + dependant=dependant, + body=body, + dependency_overrides_provider=dependency_overrides_provider, + async_exit_stack=async_exit_stack, + embed_body_fields=embed_body_fields, + ) + errors = solved_result.errors + if not errors: + raw_response = await run_endpoint_function( + dependant=dependant, + values=solved_result.values, + is_coroutine=is_coroutine, + ) + if isinstance(raw_response, Response): + if raw_response.background is None: + raw_response.background = solved_result.background_tasks + response = raw_response + else: + response_args: Dict[str, Any] = { + "background": solved_result.background_tasks + } + # If status_code was set, use it, otherwise use the default from the + # response class, in the case of redirect it's 307 + current_status_code = ( + status_code + if status_code + else solved_result.response.status_code + ) + if current_status_code is not None: + response_args["status_code"] = current_status_code + if solved_result.response.status_code: + response_args["status_code"] = ( + solved_result.response.status_code + ) + content = await serialize_response( + field=response_field, + response_content=raw_response, + include=response_model_include, + exclude=response_model_exclude, + by_alias=response_model_by_alias, + exclude_unset=response_model_exclude_unset, + exclude_defaults=response_model_exclude_defaults, + exclude_none=response_model_exclude_none, + is_coroutine=is_coroutine, + ) + response = actual_response_class(content, **response_args) + if not is_body_allowed_for_status_code(response.status_code): + response.body = b"" + response.headers.raw.extend(solved_result.response.headers.raw) + if errors: + validation_error = RequestValidationError( + _normalize_errors(errors), body=body + ) + raise validation_error + if response is None: + raise FastAPIError( + "No response object was returned. There's a high chance that the " + "application code is raising an exception and a dependency with yield " + "has a block with a bare except, or a block with except Exception, " + "and is not raising the exception again. Read more about it in the " + "docs: https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-with-yield/#dependencies-with-yield-and-except" + ) + return response + + return app + + +def get_websocket_app( + dependant: Dependant, + dependency_overrides_provider: Optional[Any] = None, + embed_body_fields: bool = False, +) -> Callable[[WebSocket], Coroutine[Any, Any, Any]]: + async def app(websocket: WebSocket) -> None: + async with AsyncExitStack() as async_exit_stack: + # TODO: remove this scope later, after a few releases + # This scope fastapi_astack is no longer used by FastAPI, kept for + # compatibility, just in case + websocket.scope["fastapi_astack"] = async_exit_stack + solved_result = await solve_dependencies( + request=websocket, + dependant=dependant, + dependency_overrides_provider=dependency_overrides_provider, + async_exit_stack=async_exit_stack, + embed_body_fields=embed_body_fields, + ) + if solved_result.errors: + raise WebSocketRequestValidationError( + _normalize_errors(solved_result.errors) + ) + assert dependant.call is not None, "dependant.call must be a function" + await dependant.call(**solved_result.values) + + return app + + +class APIWebSocketRoute(routing.WebSocketRoute): + def __init__( + self, + path: str, + endpoint: Callable[..., Any], + *, + name: Optional[str] = None, + dependencies: Optional[Sequence[params.Depends]] = None, + dependency_overrides_provider: Optional[Any] = None, + ) -> None: + self.path = path + self.endpoint = endpoint + self.name = get_name(endpoint) if name is None else name + self.dependencies = list(dependencies or []) + self.path_regex, self.path_format, self.param_convertors = compile_path(path) + self.dependant = get_dependant(path=self.path_format, call=self.endpoint) + for depends in self.dependencies[::-1]: + self.dependant.dependencies.insert( + 0, + get_parameterless_sub_dependant(depends=depends, path=self.path_format), + ) + self._flat_dependant = get_flat_dependant(self.dependant) + self._embed_body_fields = _should_embed_body_fields( + self._flat_dependant.body_params + ) + self.app = websocket_session( + get_websocket_app( + dependant=self.dependant, + dependency_overrides_provider=dependency_overrides_provider, + embed_body_fields=self._embed_body_fields, + ) + ) + + def matches(self, scope: Scope) -> Tuple[Match, Scope]: + match, child_scope = super().matches(scope) + if match != Match.NONE: + child_scope["route"] = self + return match, child_scope + + +class APIRoute(routing.Route): + def __init__( + self, + path: str, + endpoint: Callable[..., Any], + *, + response_model: Any = Default(None), + status_code: Optional[int] = None, + tags: Optional[List[Union[str, Enum]]] = None, + dependencies: Optional[Sequence[params.Depends]] = None, + summary: Optional[str] = None, + description: Optional[str] = None, + response_description: str = "Successful Response", + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + deprecated: Optional[bool] = None, + name: Optional[str] = None, + methods: Optional[Union[Set[str], List[str]]] = None, + operation_id: Optional[str] = None, + response_model_include: Optional[IncEx] = None, + response_model_exclude: Optional[IncEx] = None, + response_model_by_alias: bool = True, + response_model_exclude_unset: bool = False, + response_model_exclude_defaults: bool = False, + response_model_exclude_none: bool = False, + include_in_schema: bool = True, + response_class: Union[Type[Response], DefaultPlaceholder] = Default( + JSONResponse + ), + dependency_overrides_provider: Optional[Any] = None, + callbacks: Optional[List[BaseRoute]] = None, + openapi_extra: Optional[Dict[str, Any]] = None, + generate_unique_id_function: Union[ + Callable[["APIRoute"], str], DefaultPlaceholder + ] = Default(generate_unique_id), + ) -> None: + self.path = path + self.endpoint = endpoint + if isinstance(response_model, DefaultPlaceholder): + return_annotation = get_typed_return_annotation(endpoint) + if lenient_issubclass(return_annotation, Response): + response_model = None + else: + response_model = return_annotation + self.response_model = response_model + self.summary = summary + self.response_description = response_description + self.deprecated = deprecated + self.operation_id = operation_id + self.response_model_include = response_model_include + self.response_model_exclude = response_model_exclude + self.response_model_by_alias = response_model_by_alias + self.response_model_exclude_unset = response_model_exclude_unset + self.response_model_exclude_defaults = response_model_exclude_defaults + self.response_model_exclude_none = response_model_exclude_none + self.include_in_schema = include_in_schema + self.response_class = response_class + self.dependency_overrides_provider = dependency_overrides_provider + self.callbacks = callbacks + self.openapi_extra = openapi_extra + self.generate_unique_id_function = generate_unique_id_function + self.tags = tags or [] + self.responses = responses or {} + self.name = get_name(endpoint) if name is None else name + self.path_regex, self.path_format, self.param_convertors = compile_path(path) + if methods is None: + methods = ["GET"] + self.methods: Set[str] = {method.upper() for method in methods} + if isinstance(generate_unique_id_function, DefaultPlaceholder): + current_generate_unique_id: Callable[[APIRoute], str] = ( + generate_unique_id_function.value + ) + else: + current_generate_unique_id = generate_unique_id_function + self.unique_id = self.operation_id or current_generate_unique_id(self) + # normalize enums e.g. http.HTTPStatus + if isinstance(status_code, IntEnum): + status_code = int(status_code) + self.status_code = status_code + if self.response_model: + assert is_body_allowed_for_status_code( + status_code + ), f"Status code {status_code} must not have a response body" + response_name = "Response_" + self.unique_id + self.response_field = create_model_field( + name=response_name, + type_=self.response_model, + mode="serialization", + ) + # Create a clone of the field, so that a Pydantic submodel is not returned + # as is just because it's an instance of a subclass of a more limited class + # e.g. UserInDB (containing hashed_password) could be a subclass of User + # that doesn't have the hashed_password. But because it's a subclass, it + # would pass the validation and be returned as is. + # By being a new field, no inheritance will be passed as is. A new model + # will always be created. + # TODO: remove when deprecating Pydantic v1 + self.secure_cloned_response_field: Optional[ModelField] = ( + create_cloned_field(self.response_field) + ) + else: + self.response_field = None # type: ignore + self.secure_cloned_response_field = None + self.dependencies = list(dependencies or []) + self.description = description or inspect.cleandoc(self.endpoint.__doc__ or "") + # if a "form feed" character (page break) is found in the description text, + # truncate description text to the content preceding the first "form feed" + self.description = self.description.split("\f")[0].strip() + response_fields = {} + for additional_status_code, response in self.responses.items(): + assert isinstance(response, dict), "An additional response must be a dict" + model = response.get("model") + if model: + assert is_body_allowed_for_status_code( + additional_status_code + ), f"Status code {additional_status_code} must not have a response body" + response_name = f"Response_{additional_status_code}_{self.unique_id}" + response_field = create_model_field( + name=response_name, type_=model, mode="serialization" + ) + response_fields[additional_status_code] = response_field + if response_fields: + self.response_fields: Dict[Union[int, str], ModelField] = response_fields + else: + self.response_fields = {} + + assert callable(endpoint), "An endpoint must be a callable" + self.dependant = get_dependant(path=self.path_format, call=self.endpoint) + for depends in self.dependencies[::-1]: + self.dependant.dependencies.insert( + 0, + get_parameterless_sub_dependant(depends=depends, path=self.path_format), + ) + self._flat_dependant = get_flat_dependant(self.dependant) + self._embed_body_fields = _should_embed_body_fields( + self._flat_dependant.body_params + ) + self.body_field = get_body_field( + flat_dependant=self._flat_dependant, + name=self.unique_id, + embed_body_fields=self._embed_body_fields, + ) + self.app = request_response(self.get_route_handler()) + + def get_route_handler(self) -> Callable[[Request], Coroutine[Any, Any, Response]]: + return get_request_handler( + dependant=self.dependant, + body_field=self.body_field, + status_code=self.status_code, + response_class=self.response_class, + response_field=self.secure_cloned_response_field, + response_model_include=self.response_model_include, + response_model_exclude=self.response_model_exclude, + response_model_by_alias=self.response_model_by_alias, + response_model_exclude_unset=self.response_model_exclude_unset, + response_model_exclude_defaults=self.response_model_exclude_defaults, + response_model_exclude_none=self.response_model_exclude_none, + dependency_overrides_provider=self.dependency_overrides_provider, + embed_body_fields=self._embed_body_fields, + ) + + def matches(self, scope: Scope) -> Tuple[Match, Scope]: + match, child_scope = super().matches(scope) + if match != Match.NONE: + child_scope["route"] = self + return match, child_scope + + +class APIRouter(routing.Router): + """ + `APIRouter` class, used to group *path operations*, for example to structure + an app in multiple files. It would then be included in the `FastAPI` app, or + in another `APIRouter` (ultimately included in the app). + + Read more about it in the + [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/). + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + + app = FastAPI() + router = APIRouter() + + + @router.get("/users/", tags=["users"]) + async def read_users(): + return [{"username": "Rick"}, {"username": "Morty"}] + + + app.include_router(router) + ``` + """ + + def __init__( + self, + *, + prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "", + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to all the *path operations* in this + router. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to all the + *path operations* in this router. + + Read more about it in the + [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + """ + ), + ] = None, + default_response_class: Annotated[ + Type[Response], + Doc( + """ + The default response class to be used. + + Read more in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class). + """ + ), + ] = Default(JSONResponse), + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses to be shown in OpenAPI. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/). + + And in the + [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + OpenAPI callbacks that should apply to all *path operations* in this + router. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + routes: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + **Note**: you probably shouldn't use this parameter, it is inherited + from Starlette and supported for compatibility. + + --- + + A list of routes to serve incoming HTTP and WebSocket requests. + """ + ), + deprecated( + """ + You normally wouldn't use this parameter with FastAPI, it is inherited + from Starlette and supported for compatibility. + + In FastAPI, you normally would use the *path operation methods*, + like `router.get()`, `router.post()`, etc. + """ + ), + ] = None, + redirect_slashes: Annotated[ + bool, + Doc( + """ + Whether to detect and redirect slashes in URLs when the client doesn't + use the same format. + """ + ), + ] = True, + default: Annotated[ + Optional[ASGIApp], + Doc( + """ + Default function handler for this router. Used to handle + 404 Not Found errors. + """ + ), + ] = None, + dependency_overrides_provider: Annotated[ + Optional[Any], + Doc( + """ + Only used internally by FastAPI to handle dependency overrides. + + You shouldn't need to use it. It normally points to the `FastAPI` app + object. + """ + ), + ] = None, + route_class: Annotated[ + Type[APIRoute], + Doc( + """ + Custom route (*path operation*) class to be used by this router. + + Read more about it in the + [FastAPI docs for Custom Request and APIRoute class](https://fastapi.tiangolo.com/how-to/custom-request-and-route/#custom-apiroute-class-in-a-router). + """ + ), + ] = APIRoute, + on_startup: Annotated[ + Optional[Sequence[Callable[[], Any]]], + Doc( + """ + A list of startup event handler functions. + + You should instead use the `lifespan` handlers. + + Read more in the [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/). + """ + ), + ] = None, + on_shutdown: Annotated[ + Optional[Sequence[Callable[[], Any]]], + Doc( + """ + A list of shutdown event handler functions. + + You should instead use the `lifespan` handlers. + + Read more in the + [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/). + """ + ), + ] = None, + # the generic to Lifespan[AppType] is the type of the top level application + # which the router cannot know statically, so we use typing.Any + lifespan: Annotated[ + Optional[Lifespan[Any]], + Doc( + """ + A `Lifespan` context manager handler. This replaces `startup` and + `shutdown` functions with a single context manager. + + Read more in the + [FastAPI docs for `lifespan`](https://fastapi.tiangolo.com/advanced/events/). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark all *path operations* in this router as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + To include (or not) all the *path operations* in this router in the + generated OpenAPI. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> None: + super().__init__( + routes=routes, + redirect_slashes=redirect_slashes, + default=default, + on_startup=on_startup, + on_shutdown=on_shutdown, + lifespan=lifespan, + ) + if prefix: + assert prefix.startswith("/"), "A path prefix must start with '/'" + assert not prefix.endswith( + "/" + ), "A path prefix must not end with '/', as the routes will start with '/'" + self.prefix = prefix + self.tags: List[Union[str, Enum]] = tags or [] + self.dependencies = list(dependencies or []) + self.deprecated = deprecated + self.include_in_schema = include_in_schema + self.responses = responses or {} + self.callbacks = callbacks or [] + self.dependency_overrides_provider = dependency_overrides_provider + self.route_class = route_class + self.default_response_class = default_response_class + self.generate_unique_id_function = generate_unique_id_function + + def route( + self, + path: str, + methods: Optional[List[str]] = None, + name: Optional[str] = None, + include_in_schema: bool = True, + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_route( + path, + func, + methods=methods, + name=name, + include_in_schema=include_in_schema, + ) + return func + + return decorator + + def add_api_route( + self, + path: str, + endpoint: Callable[..., Any], + *, + response_model: Any = Default(None), + status_code: Optional[int] = None, + tags: Optional[List[Union[str, Enum]]] = None, + dependencies: Optional[Sequence[params.Depends]] = None, + summary: Optional[str] = None, + description: Optional[str] = None, + response_description: str = "Successful Response", + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + deprecated: Optional[bool] = None, + methods: Optional[Union[Set[str], List[str]]] = None, + operation_id: Optional[str] = None, + response_model_include: Optional[IncEx] = None, + response_model_exclude: Optional[IncEx] = None, + response_model_by_alias: bool = True, + response_model_exclude_unset: bool = False, + response_model_exclude_defaults: bool = False, + response_model_exclude_none: bool = False, + include_in_schema: bool = True, + response_class: Union[Type[Response], DefaultPlaceholder] = Default( + JSONResponse + ), + name: Optional[str] = None, + route_class_override: Optional[Type[APIRoute]] = None, + callbacks: Optional[List[BaseRoute]] = None, + openapi_extra: Optional[Dict[str, Any]] = None, + generate_unique_id_function: Union[ + Callable[[APIRoute], str], DefaultPlaceholder + ] = Default(generate_unique_id), + ) -> None: + route_class = route_class_override or self.route_class + responses = responses or {} + combined_responses = {**self.responses, **responses} + current_response_class = get_value_or_default( + response_class, self.default_response_class + ) + current_tags = self.tags.copy() + if tags: + current_tags.extend(tags) + current_dependencies = self.dependencies.copy() + if dependencies: + current_dependencies.extend(dependencies) + current_callbacks = self.callbacks.copy() + if callbacks: + current_callbacks.extend(callbacks) + current_generate_unique_id = get_value_or_default( + generate_unique_id_function, self.generate_unique_id_function + ) + route = route_class( + self.prefix + path, + endpoint=endpoint, + response_model=response_model, + status_code=status_code, + tags=current_tags, + dependencies=current_dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=combined_responses, + deprecated=deprecated or self.deprecated, + methods=methods, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema and self.include_in_schema, + response_class=current_response_class, + name=name, + dependency_overrides_provider=self.dependency_overrides_provider, + callbacks=current_callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=current_generate_unique_id, + ) + self.routes.append(route) + + def api_route( + self, + path: str, + *, + response_model: Any = Default(None), + status_code: Optional[int] = None, + tags: Optional[List[Union[str, Enum]]] = None, + dependencies: Optional[Sequence[params.Depends]] = None, + summary: Optional[str] = None, + description: Optional[str] = None, + response_description: str = "Successful Response", + responses: Optional[Dict[Union[int, str], Dict[str, Any]]] = None, + deprecated: Optional[bool] = None, + methods: Optional[List[str]] = None, + operation_id: Optional[str] = None, + response_model_include: Optional[IncEx] = None, + response_model_exclude: Optional[IncEx] = None, + response_model_by_alias: bool = True, + response_model_exclude_unset: bool = False, + response_model_exclude_defaults: bool = False, + response_model_exclude_none: bool = False, + include_in_schema: bool = True, + response_class: Type[Response] = Default(JSONResponse), + name: Optional[str] = None, + callbacks: Optional[List[BaseRoute]] = None, + openapi_extra: Optional[Dict[str, Any]] = None, + generate_unique_id_function: Callable[[APIRoute], str] = Default( + generate_unique_id + ), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_api_route( + path, + func, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=methods, + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + return func + + return decorator + + def add_api_websocket_route( + self, + path: str, + endpoint: Callable[..., Any], + name: Optional[str] = None, + *, + dependencies: Optional[Sequence[params.Depends]] = None, + ) -> None: + current_dependencies = self.dependencies.copy() + if dependencies: + current_dependencies.extend(dependencies) + + route = APIWebSocketRoute( + self.prefix + path, + endpoint=endpoint, + name=name, + dependencies=current_dependencies, + dependency_overrides_provider=self.dependency_overrides_provider, + ) + self.routes.append(route) + + def websocket( + self, + path: Annotated[ + str, + Doc( + """ + WebSocket path. + """ + ), + ], + name: Annotated[ + Optional[str], + Doc( + """ + A name for the WebSocket. Only used internally. + """ + ), + ] = None, + *, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be used for this + WebSocket. + + Read more about it in the + [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/). + """ + ), + ] = None, + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Decorate a WebSocket function. + + Read more about it in the + [FastAPI docs for WebSockets](https://fastapi.tiangolo.com/advanced/websockets/). + + **Example** + + ## Example + + ```python + from fastapi import APIRouter, FastAPI, WebSocket + + app = FastAPI() + router = APIRouter() + + @router.websocket("/ws") + async def websocket_endpoint(websocket: WebSocket): + await websocket.accept() + while True: + data = await websocket.receive_text() + await websocket.send_text(f"Message text was: {data}") + + app.include_router(router) + ``` + """ + + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_api_websocket_route( + path, func, name=name, dependencies=dependencies + ) + return func + + return decorator + + def websocket_route( + self, path: str, name: Union[str, None] = None + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_websocket_route(path, func, name=name) + return func + + return decorator + + def include_router( + self, + router: Annotated["APIRouter", Doc("The `APIRouter` to include.")], + *, + prefix: Annotated[str, Doc("An optional path prefix for the router.")] = "", + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to all the *path operations* in this + router. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to all the + *path operations* in this router. + + Read more about it in the + [FastAPI docs for Bigger Applications - Multiple Files](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + """ + ), + ] = None, + default_response_class: Annotated[ + Type[Response], + Doc( + """ + The default response class to be used. + + Read more in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#default-response-class). + """ + ), + ] = Default(JSONResponse), + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses to be shown in OpenAPI. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Additional Responses in OpenAPI](https://fastapi.tiangolo.com/advanced/additional-responses/). + + And in the + [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/#include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies). + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + OpenAPI callbacks that should apply to all *path operations* in this + router. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark all *path operations* in this router as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include (or not) all the *path operations* in this router in the + generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = True, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> None: + """ + Include another `APIRouter` in the same current `APIRouter`. + + Read more about it in the + [FastAPI docs for Bigger Applications](https://fastapi.tiangolo.com/tutorial/bigger-applications/). + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + + app = FastAPI() + internal_router = APIRouter() + users_router = APIRouter() + + @users_router.get("/users/") + def read_users(): + return [{"name": "Rick"}, {"name": "Morty"}] + + internal_router.include_router(users_router) + app.include_router(internal_router) + ``` + """ + if prefix: + assert prefix.startswith("/"), "A path prefix must start with '/'" + assert not prefix.endswith( + "/" + ), "A path prefix must not end with '/', as the routes will start with '/'" + else: + for r in router.routes: + path = getattr(r, "path") # noqa: B009 + name = getattr(r, "name", "unknown") + if path is not None and not path: + raise FastAPIError( + f"Prefix and path cannot be both empty (path operation: {name})" + ) + if responses is None: + responses = {} + for route in router.routes: + if isinstance(route, APIRoute): + combined_responses = {**responses, **route.responses} + use_response_class = get_value_or_default( + route.response_class, + router.default_response_class, + default_response_class, + self.default_response_class, + ) + current_tags = [] + if tags: + current_tags.extend(tags) + if route.tags: + current_tags.extend(route.tags) + current_dependencies: List[params.Depends] = [] + if dependencies: + current_dependencies.extend(dependencies) + if route.dependencies: + current_dependencies.extend(route.dependencies) + current_callbacks = [] + if callbacks: + current_callbacks.extend(callbacks) + if route.callbacks: + current_callbacks.extend(route.callbacks) + current_generate_unique_id = get_value_or_default( + route.generate_unique_id_function, + router.generate_unique_id_function, + generate_unique_id_function, + self.generate_unique_id_function, + ) + self.add_api_route( + prefix + route.path, + route.endpoint, + response_model=route.response_model, + status_code=route.status_code, + tags=current_tags, + dependencies=current_dependencies, + summary=route.summary, + description=route.description, + response_description=route.response_description, + responses=combined_responses, + deprecated=route.deprecated or deprecated or self.deprecated, + methods=route.methods, + operation_id=route.operation_id, + response_model_include=route.response_model_include, + response_model_exclude=route.response_model_exclude, + response_model_by_alias=route.response_model_by_alias, + response_model_exclude_unset=route.response_model_exclude_unset, + response_model_exclude_defaults=route.response_model_exclude_defaults, + response_model_exclude_none=route.response_model_exclude_none, + include_in_schema=route.include_in_schema + and self.include_in_schema + and include_in_schema, + response_class=use_response_class, + name=route.name, + route_class_override=type(route), + callbacks=current_callbacks, + openapi_extra=route.openapi_extra, + generate_unique_id_function=current_generate_unique_id, + ) + elif isinstance(route, routing.Route): + methods = list(route.methods or []) + self.add_route( + prefix + route.path, + route.endpoint, + methods=methods, + include_in_schema=route.include_in_schema, + name=route.name, + ) + elif isinstance(route, APIWebSocketRoute): + current_dependencies = [] + if dependencies: + current_dependencies.extend(dependencies) + if route.dependencies: + current_dependencies.extend(route.dependencies) + self.add_api_websocket_route( + prefix + route.path, + route.endpoint, + dependencies=current_dependencies, + name=route.name, + ) + elif isinstance(route, routing.WebSocketRoute): + self.add_websocket_route( + prefix + route.path, route.endpoint, name=route.name + ) + for handler in router.on_startup: + self.add_event_handler("startup", handler) + for handler in router.on_shutdown: + self.add_event_handler("shutdown", handler) + self.lifespan_context = _merge_lifespan_context( + self.lifespan_context, + router.lifespan_context, + ) + + def get( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP GET operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + + app = FastAPI() + router = APIRouter() + + @router.get("/items/") + def read_items(): + return [{"name": "Empanada"}, {"name": "Arepa"}] + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["GET"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def put( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP PUT operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + router = APIRouter() + + @router.put("/items/{item_id}") + def replace_item(item_id: str, item: Item): + return {"message": "Item replaced", "id": item_id} + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["PUT"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def post( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP POST operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + router = APIRouter() + + @router.post("/items/") + def create_item(item: Item): + return {"message": "Item created"} + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["POST"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def delete( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP DELETE operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + + app = FastAPI() + router = APIRouter() + + @router.delete("/items/{item_id}") + def delete_item(item_id: str): + return {"message": "Item deleted"} + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["DELETE"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def options( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP OPTIONS operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + + app = FastAPI() + router = APIRouter() + + @router.options("/items/") + def get_item_options(): + return {"additions": ["Aji", "Guacamole"]} + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["OPTIONS"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def head( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP HEAD operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + router = APIRouter() + + @router.head("/items/", status_code=204) + def get_items_headers(response: Response): + response.headers["X-Cat-Dog"] = "Alone in the world" + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["HEAD"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def patch( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP PATCH operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + router = APIRouter() + + @router.patch("/items/") + def update_item(item: Item): + return {"message": "Item updated in place"} + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["PATCH"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + def trace( + self, + path: Annotated[ + str, + Doc( + """ + The URL path to be used for this *path operation*. + + For example, in `http://example.com/items`, the path is `/items`. + """ + ), + ], + *, + response_model: Annotated[ + Any, + Doc( + """ + The type to use for the response. + + It could be any valid Pydantic *field* type. So, it doesn't have to + be a Pydantic model, it could be other things, like a `list`, `dict`, + etc. + + It will be used for: + + * Documentation: the generated OpenAPI (and the UI at `/docs`) will + show it as the response (JSON Schema). + * Serialization: you could return an arbitrary object and the + `response_model` would be used to serialize that object into the + corresponding JSON. + * Filtering: the JSON sent to the client will only contain the data + (fields) defined in the `response_model`. If you returned an object + that contains an attribute `password` but the `response_model` does + not include that field, the JSON sent to the client would not have + that `password`. + * Validation: whatever you return will be serialized with the + `response_model`, converting any data as necessary to generate the + corresponding JSON. But if the data in the object returned is not + valid, that would mean a violation of the contract with the client, + so it's an error from the API developer. So, FastAPI will raise an + error and return a 500 error code (Internal Server Error). + + Read more about it in the + [FastAPI docs for Response Model](https://fastapi.tiangolo.com/tutorial/response-model/). + """ + ), + ] = Default(None), + status_code: Annotated[ + Optional[int], + Doc( + """ + The default status code to be used for the response. + + You could override the status code by returning a response directly. + + Read more about it in the + [FastAPI docs for Response Status Code](https://fastapi.tiangolo.com/tutorial/response-status-code/). + """ + ), + ] = None, + tags: Annotated[ + Optional[List[Union[str, Enum]]], + Doc( + """ + A list of tags to be applied to the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/#tags). + """ + ), + ] = None, + dependencies: Annotated[ + Optional[Sequence[params.Depends]], + Doc( + """ + A list of dependencies (using `Depends()`) to be applied to the + *path operation*. + + Read more about it in the + [FastAPI docs for Dependencies in path operation decorators](https://fastapi.tiangolo.com/tutorial/dependencies/dependencies-in-path-operation-decorators/). + """ + ), + ] = None, + summary: Annotated[ + Optional[str], + Doc( + """ + A summary for the *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + A description for the *path operation*. + + If not provided, it will be extracted automatically from the docstring + of the *path operation function*. + + It can contain Markdown. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Path Operation Configuration](https://fastapi.tiangolo.com/tutorial/path-operation-configuration/). + """ + ), + ] = None, + response_description: Annotated[ + str, + Doc( + """ + The description for the default response. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = "Successful Response", + responses: Annotated[ + Optional[Dict[Union[int, str], Dict[str, Any]]], + Doc( + """ + Additional responses that could be returned by this *path operation*. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + deprecated: Annotated[ + Optional[bool], + Doc( + """ + Mark this *path operation* as deprecated. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + operation_id: Annotated[ + Optional[str], + Doc( + """ + Custom operation ID to be used by this *path operation*. + + By default, it is generated automatically. + + If you provide a custom operation ID, you need to make sure it is + unique for the whole API. + + You can customize the + operation ID generation with the parameter + `generate_unique_id_function` in the `FastAPI` class. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = None, + response_model_include: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to include only certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_exclude: Annotated[ + Optional[IncEx], + Doc( + """ + Configuration passed to Pydantic to exclude certain fields in the + response data. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = None, + response_model_by_alias: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response model + should be serialized by alias when an alias is used. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_include-and-response_model_exclude). + """ + ), + ] = True, + response_model_exclude_unset: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that were not set and + have their default values. This is different from + `response_model_exclude_defaults` in that if the fields are set, + they will be included in the response, even if the value is the same + as the default. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_defaults: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data + should have all the fields, including the ones that have the same value + as the default. This is different from `response_model_exclude_unset` + in that if the fields are set but contain the same default values, + they will be excluded from the response. + + When `True`, default values are omitted from the response. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#use-the-response_model_exclude_unset-parameter). + """ + ), + ] = False, + response_model_exclude_none: Annotated[ + bool, + Doc( + """ + Configuration passed to Pydantic to define if the response data should + exclude fields set to `None`. + + This is much simpler (less smart) than `response_model_exclude_unset` + and `response_model_exclude_defaults`. You probably want to use one of + those two instead of this one, as those allow returning `None` values + when it makes sense. + + Read more about it in the + [FastAPI docs for Response Model - Return Type](https://fastapi.tiangolo.com/tutorial/response-model/#response_model_exclude_none). + """ + ), + ] = False, + include_in_schema: Annotated[ + bool, + Doc( + """ + Include this *path operation* in the generated OpenAPI schema. + + This affects the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for Query Parameters and String Validations](https://fastapi.tiangolo.com/tutorial/query-params-str-validations/#exclude-from-openapi). + """ + ), + ] = True, + response_class: Annotated[ + Type[Response], + Doc( + """ + Response class to be used for this *path operation*. + + This will not be used if you return a response directly. + + Read more about it in the + [FastAPI docs for Custom Response - HTML, Stream, File, others](https://fastapi.tiangolo.com/advanced/custom-response/#redirectresponse). + """ + ), + ] = Default(JSONResponse), + name: Annotated[ + Optional[str], + Doc( + """ + Name for this *path operation*. Only used internally. + """ + ), + ] = None, + callbacks: Annotated[ + Optional[List[BaseRoute]], + Doc( + """ + List of *path operations* that will be used as OpenAPI callbacks. + + This is only for OpenAPI documentation, the callbacks won't be used + directly. + + It will be added to the generated OpenAPI (e.g. visible at `/docs`). + + Read more about it in the + [FastAPI docs for OpenAPI Callbacks](https://fastapi.tiangolo.com/advanced/openapi-callbacks/). + """ + ), + ] = None, + openapi_extra: Annotated[ + Optional[Dict[str, Any]], + Doc( + """ + Extra metadata to be included in the OpenAPI schema for this *path + operation*. + + Read more about it in the + [FastAPI docs for Path Operation Advanced Configuration](https://fastapi.tiangolo.com/advanced/path-operation-advanced-configuration/#custom-openapi-path-operation-schema). + """ + ), + ] = None, + generate_unique_id_function: Annotated[ + Callable[[APIRoute], str], + Doc( + """ + Customize the function used to generate unique IDs for the *path + operations* shown in the generated OpenAPI. + + This is particularly useful when automatically generating clients or + SDKs for your API. + + Read more about it in the + [FastAPI docs about how to Generate Clients](https://fastapi.tiangolo.com/advanced/generate-clients/#custom-generate-unique-id-function). + """ + ), + ] = Default(generate_unique_id), + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add a *path operation* using an HTTP TRACE operation. + + ## Example + + ```python + from fastapi import APIRouter, FastAPI + from pydantic import BaseModel + + class Item(BaseModel): + name: str + description: str | None = None + + app = FastAPI() + router = APIRouter() + + @router.trace("/items/{item_id}") + def trace_item(item_id: str): + return None + + app.include_router(router) + ``` + """ + return self.api_route( + path=path, + response_model=response_model, + status_code=status_code, + tags=tags, + dependencies=dependencies, + summary=summary, + description=description, + response_description=response_description, + responses=responses, + deprecated=deprecated, + methods=["TRACE"], + operation_id=operation_id, + response_model_include=response_model_include, + response_model_exclude=response_model_exclude, + response_model_by_alias=response_model_by_alias, + response_model_exclude_unset=response_model_exclude_unset, + response_model_exclude_defaults=response_model_exclude_defaults, + response_model_exclude_none=response_model_exclude_none, + include_in_schema=include_in_schema, + response_class=response_class, + name=name, + callbacks=callbacks, + openapi_extra=openapi_extra, + generate_unique_id_function=generate_unique_id_function, + ) + + @deprecated( + """ + on_event is deprecated, use lifespan event handlers instead. + + Read more about it in the + [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/). + """ + ) + def on_event( + self, + event_type: Annotated[ + str, + Doc( + """ + The type of event. `startup` or `shutdown`. + """ + ), + ], + ) -> Callable[[DecoratedCallable], DecoratedCallable]: + """ + Add an event handler for the router. + + `on_event` is deprecated, use `lifespan` event handlers instead. + + Read more about it in the + [FastAPI docs for Lifespan Events](https://fastapi.tiangolo.com/advanced/events/#alternative-events-deprecated). + """ + + def decorator(func: DecoratedCallable) -> DecoratedCallable: + self.add_event_handler(event_type, func) + return func + + return decorator diff --git a/.venv/Lib/site-packages/fastapi/security/__init__.py b/.venv/Lib/site-packages/fastapi/security/__init__.py new file mode 100644 index 0000000..3aa6bf2 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/security/__init__.py @@ -0,0 +1,15 @@ +from .api_key import APIKeyCookie as APIKeyCookie +from .api_key import APIKeyHeader as APIKeyHeader +from .api_key import APIKeyQuery as APIKeyQuery +from .http import HTTPAuthorizationCredentials as HTTPAuthorizationCredentials +from .http import HTTPBasic as HTTPBasic +from .http import HTTPBasicCredentials as HTTPBasicCredentials +from .http import HTTPBearer as HTTPBearer +from .http import HTTPDigest as HTTPDigest +from .oauth2 import OAuth2 as OAuth2 +from .oauth2 import OAuth2AuthorizationCodeBearer as OAuth2AuthorizationCodeBearer +from .oauth2 import OAuth2PasswordBearer as OAuth2PasswordBearer +from .oauth2 import OAuth2PasswordRequestForm as OAuth2PasswordRequestForm +from .oauth2 import OAuth2PasswordRequestFormStrict as OAuth2PasswordRequestFormStrict +from .oauth2 import SecurityScopes as SecurityScopes +from .open_id_connect_url import OpenIdConnect as OpenIdConnect diff --git a/.venv/Lib/site-packages/fastapi/security/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/security/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3f7900371d6a10304fb0e019da52b91ea85ead3c GIT binary patch literal 870 zcmZ{i%Wl*#6o#F-WUiS@TM1PHu>px9wF4C!5Gu5TPz$IHox;M36uF6+F_Xlp?G%L< z;Td=X-hnrW6gI5bA$7-!V^3Q&3oPr`_n%|?94G$nIBf*uu3JvestEnm=4w z7Zjq=^C>_i)d!1Kh`b!#&^u9vJRN!*~U+SSTNC41ZbB{)Sa_cin^6 zG#_(5XY`-nrzE5Td}on=n^BR2y}5sK;_hZ@#s&LK6ywQQ(2ypIkw`+mrSp44vH;B5 zwOL-&HgQUXsbJg-HlNcXNbt}Pb0M9NQGgxB%)<@hl@%i!#n zT*Pqd?f)hxO0Yn;(3{X86HMikfTvX7$~j7DauAMrlF&dMZmbp!k}`iza{GZBd)WWJ&c zQ1mAoKk?p4Dx^nPD46uzJeUy?yMlj&2BnvZ%_&W&Ac_kw;#29Jg8C#){WzOHe&B7L z)8yQH!%jWP6x~coFemT_ybnYwxY|fweu9zjvxF(%-%9hM`84KX7SSEC4qfO6B)36+ rS1rpb(L*ywB|0q8y%Oz|=)ReEN_1SJ=OuboqW2|w^aDK;H(=Xeh_v~! literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/security/__pycache__/api_key.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/security/__pycache__/api_key.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..512dba52c7f435061afe3ca36172e1924c63ae85 GIT binary patch literal 9721 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 Jofo+>{{=CHw-5jT literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/security/__pycache__/base.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/security/__pycache__/base.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..72c930d30c54e0e6a0dd9f07573f85dda74f555e GIT binary patch literal 532 zcmYjOJxc^J6nxp;6H!k&Q7bFaVhc}OMJ!aXQ8^HsBM@@C&vSLZO!f}8*V5YGApR6f zEo8yU%1*pOu<|8)f`LqC!n~Jc^3-fj0gbiJTmO#McO(9WHzuQ1BKHtN$YMxX*J0qm zA%xBigzlqLySl9O{Kkh7KC5OTw&$UPu*SqNR{4A4a{WIMEr z4PuUArR#gjR8);53o)*yb#Q?Ric}_e;!jkQ!crlsDIv%*h>`e=5Z4148xyJ4|GOO9 zHgiJAG|dWGL|LlIc?ex^}rE~8LIns>_JLaL;rvP%pK&2zQh#}t(; zGR5PpuX&G9$UGOx;A(4=w}+Sx`BBv4Ix28Im%)|nqvq#Q7c!4FC=wgaMvu~I=cRq3 z1rxcRCAfvx>E&l{`L(t1;w>n%Weq33TP=esf}=(>yfPSrGEYvzbmlRI@Z byQ)Q!(bV$ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/security/__pycache__/http.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/security/__pycache__/http.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6a7d6bd089bb363fe81ee4ebd2c998b2fe92d5d4 GIT binary patch literal 13659 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/security/__pycache__/oauth2.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/security/__pycache__/oauth2.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5a1f5d6c11bf7cc03bcbbb539b7861866c2d3b6b GIT binary patch literal 18301 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/fastapi/security/__pycache__/open_id_connect_url.cpython-312.pyc b/.venv/Lib/site-packages/fastapi/security/__pycache__/open_id_connect_url.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8aaa199a462d7420f021ac88cf6e54106ccf2534 GIT binary patch literal 3243 zcmcgu&2JmW6`$SZw@6V`WLmB5WRN(C=nvXWilS`-2XY)YLL6DJ&#* zzS;NY&HMPhH~T@MkRvc2U%0#S7ofhv#b6}+#Et~w7U6^&9%&gh!$8{f%$8M4Xxj3U ztyC?g>4cYVWoj8sC%tSdSIcQS<&CxSwY;X&UZFK!8*deBMT3~+H-u-l2+xYtZ7V*r zW_5Fwv2SrvF`~@HcIXB^^MEc~Yzu#mKOgwMa6)*Izbu@Nbi?jhrUVMSxVX6R!ZkD$gOi%cjhe+x__KK8PZm##gh-l1qO=Mp-9p3O{rm zhH<5i$CRqlS)aPT3YqT+8Z@XI()FO@ak?yMM+r`uqD*V!0&>8G?{uqrJ-=A7qA}$( zMN8N|Yl&!#3*|^xry$C~ae*zQ3}iGBJea;K(%bl%R)I$1SZs=6W3ODg5FZmuP%882 z*v&orkT(DVjV+;QNi{bjHV1yWo`-I^zT;R)(C zs2@-)6FLhZ38cFbW27k<7m~V)wq>y9LeNf735DfKh*l$zBU*nHa&S;T3y6&t9N{p} z>rw~7=jmLaa;Vx7z0BuS0sOR(3NbZHlVOXz?SAq@k%be?%iES;e1 zPzzeye|3Ar2+#s8gR(W|dJK>O{y^nGh_G<9DXzalgAPO#akX185HkgV)(9NY3W!{q z4}7t-j~|OoI1_$QiH(jI+uRL0be)0!;7yaQLDlyAd$3c4 zO(+3K5){vf^#fdBF@X~pi59r(wxMwD8@A56ip~IDsJO;jz=H6*VY6TJBRU5S3*%>=9l*CpwaiV63MEP|A73YAnex#!w?IpD&Jk}dtn+O}@MwjE_`-9Bww zw>XIzg4LhG!sd);I#MVRqef{}g*RLocRh_w9x~jg=b(&1J7G$sr_oS+~ z<;i|`3uN63R#bf%W}CI!cB^ysSEuXMHQ}$-FSyHf<%Z&9n>kn6ics|igDau!o>Kj5 z_7rw-+vTUlb;-#ef#L&s_#@kKQ{aEvDq7m&oa~7KRtRQ@n&%cc9JOFZwpaMim)Sn zr=Lq?>b$=W&z&upULpqMe$!Y*&d^vzbPNq{-0q{{x8|m)9^M}bvJ|EV8^g?i;^rM| zfU4JwF4;6MlfPQ)MkO&H754PejnX{!joqpe9KJxtAjDxuK}flXQe1@4Rv_`|xaq3M zS`nenxI`dIJhx)W14!eSMN~kA_j|QM?*J6Cj6BE-_SXIK62E^5q|{lMz9Ij-PPV5X z`E&7)#m}dYe>{Es?TepIKYOF_Me*=<@u5Gw`ny-ZEI;-oed?oU<{@ndCws&!P4+Tm z8rX+F${hZe2IOmJW{FYB%PBlPXWM}Cjwb-!dE0)a!#uo}VU@ORxJd!(S(LL>C?$T1 zN;E!7EC+!n58@ibEgyyH9U`ZZMz8d@jh@C}r9Omdi+pEV$xQDlQYiJNaGHVXdtv-C z`8Z(f(9!LD@r!)1XPTvn9V<~7?^(%0@jEMhDA!A)OqrA)+0IYhy!^(?S}swV+Obk7 zmqxj4IoCUga>xF++;NmULk>K=ouAOU#!=S<>MEhGhYsX+o}xwbCQ-cz5Rg zr{6ny56Re3Y%lYbi6|9z+i;!4ktz4u@dV+f>3cOZ50)?RZ$9_qz2SW7+9velg+fd+2ze_U?qVH z9&+rhXK#vs!2jUI;=wQ=3ZA@0;>nXUv5G#J$M=2jo5#m{SFg_@Q%kK+$r48Bt0jNR zKLXS11{|Om#W+P7ZsW{pI~c_d$DAyhSxmUY2`3%LvW^?OFWk0Ud4d1Ut_U1mdsHZq z_gJdECuNaxeV&!7n}c}9tR8kbi#ddSmX=)mz*Pyo$mIE3#31{o>!ux`0g|}F1GMw6 z=g1s8Z;n)Iehl%@8Il1Wm~@X(K(e6TarI+k Optional[str]: + if not api_key: + if auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, detail="Not authenticated" + ) + return None + return api_key + + +class APIKeyQuery(APIKeyBase): + """ + API key authentication using a query parameter. + + This defines the name of the query parameter that should be provided in the request + with the API key and integrates that into the OpenAPI documentation. It extracts + the key value sent in the query parameter automatically and provides it as the + dependency result. But it doesn't define how to send that API key to the client. + + ## Usage + + Create an instance object and use that object as the dependency in `Depends()`. + + The dependency result will be a string containing the key value. + + ## Example + + ```python + from fastapi import Depends, FastAPI + from fastapi.security import APIKeyQuery + + app = FastAPI() + + query_scheme = APIKeyQuery(name="api_key") + + + @app.get("/items/") + async def read_items(api_key: str = Depends(query_scheme)): + return {"api_key": api_key} + ``` + """ + + def __init__( + self, + *, + name: Annotated[ + str, + Doc("Query parameter name."), + ], + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if the query parameter is not provided, `APIKeyQuery` will + automatically cancel the request and send the client an error. + + If `auto_error` is set to `False`, when the query parameter is not + available, instead of erroring out, the dependency result will be + `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, in a query + parameter or in an HTTP Bearer token). + """ + ), + ] = True, + ): + self.model: APIKey = APIKey( + **{"in": APIKeyIn.query}, # type: ignore[arg-type] + name=name, + description=description, + ) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__(self, request: Request) -> Optional[str]: + api_key = request.query_params.get(self.model.name) + return self.check_api_key(api_key, self.auto_error) + + +class APIKeyHeader(APIKeyBase): + """ + API key authentication using a header. + + This defines the name of the header that should be provided in the request with + the API key and integrates that into the OpenAPI documentation. It extracts + the key value sent in the header automatically and provides it as the dependency + result. But it doesn't define how to send that key to the client. + + ## Usage + + Create an instance object and use that object as the dependency in `Depends()`. + + The dependency result will be a string containing the key value. + + ## Example + + ```python + from fastapi import Depends, FastAPI + from fastapi.security import APIKeyHeader + + app = FastAPI() + + header_scheme = APIKeyHeader(name="x-key") + + + @app.get("/items/") + async def read_items(key: str = Depends(header_scheme)): + return {"key": key} + ``` + """ + + def __init__( + self, + *, + name: Annotated[str, Doc("Header name.")], + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if the header is not provided, `APIKeyHeader` will + automatically cancel the request and send the client an error. + + If `auto_error` is set to `False`, when the header is not available, + instead of erroring out, the dependency result will be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, in a header or + in an HTTP Bearer token). + """ + ), + ] = True, + ): + self.model: APIKey = APIKey( + **{"in": APIKeyIn.header}, # type: ignore[arg-type] + name=name, + description=description, + ) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__(self, request: Request) -> Optional[str]: + api_key = request.headers.get(self.model.name) + return self.check_api_key(api_key, self.auto_error) + + +class APIKeyCookie(APIKeyBase): + """ + API key authentication using a cookie. + + This defines the name of the cookie that should be provided in the request with + the API key and integrates that into the OpenAPI documentation. It extracts + the key value sent in the cookie automatically and provides it as the dependency + result. But it doesn't define how to set that cookie. + + ## Usage + + Create an instance object and use that object as the dependency in `Depends()`. + + The dependency result will be a string containing the key value. + + ## Example + + ```python + from fastapi import Depends, FastAPI + from fastapi.security import APIKeyCookie + + app = FastAPI() + + cookie_scheme = APIKeyCookie(name="session") + + + @app.get("/items/") + async def read_items(session: str = Depends(cookie_scheme)): + return {"session": session} + ``` + """ + + def __init__( + self, + *, + name: Annotated[str, Doc("Cookie name.")], + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if the cookie is not provided, `APIKeyCookie` will + automatically cancel the request and send the client an error. + + If `auto_error` is set to `False`, when the cookie is not available, + instead of erroring out, the dependency result will be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, in a cookie or + in an HTTP Bearer token). + """ + ), + ] = True, + ): + self.model: APIKey = APIKey( + **{"in": APIKeyIn.cookie}, # type: ignore[arg-type] + name=name, + description=description, + ) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__(self, request: Request) -> Optional[str]: + api_key = request.cookies.get(self.model.name) + return self.check_api_key(api_key, self.auto_error) diff --git a/.venv/Lib/site-packages/fastapi/security/base.py b/.venv/Lib/site-packages/fastapi/security/base.py new file mode 100644 index 0000000..c43555d --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/security/base.py @@ -0,0 +1,6 @@ +from fastapi.openapi.models import SecurityBase as SecurityBaseModel + + +class SecurityBase: + model: SecurityBaseModel + scheme_name: str diff --git a/.venv/Lib/site-packages/fastapi/security/http.py b/.venv/Lib/site-packages/fastapi/security/http.py new file mode 100644 index 0000000..9ab2df3 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/security/http.py @@ -0,0 +1,423 @@ +import binascii +from base64 import b64decode +from typing import Optional + +from fastapi.exceptions import HTTPException +from fastapi.openapi.models import HTTPBase as HTTPBaseModel +from fastapi.openapi.models import HTTPBearer as HTTPBearerModel +from fastapi.security.base import SecurityBase +from fastapi.security.utils import get_authorization_scheme_param +from pydantic import BaseModel +from starlette.requests import Request +from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN +from typing_extensions import Annotated, Doc + + +class HTTPBasicCredentials(BaseModel): + """ + The HTTP Basic credentials given as the result of using `HTTPBasic` in a + dependency. + + Read more about it in the + [FastAPI docs for HTTP Basic Auth](https://fastapi.tiangolo.com/advanced/security/http-basic-auth/). + """ + + username: Annotated[str, Doc("The HTTP Basic username.")] + password: Annotated[str, Doc("The HTTP Basic password.")] + + +class HTTPAuthorizationCredentials(BaseModel): + """ + The HTTP authorization credentials in the result of using `HTTPBearer` or + `HTTPDigest` in a dependency. + + The HTTP authorization header value is split by the first space. + + The first part is the `scheme`, the second part is the `credentials`. + + For example, in an HTTP Bearer token scheme, the client will send a header + like: + + ``` + Authorization: Bearer deadbeef12346 + ``` + + In this case: + + * `scheme` will have the value `"Bearer"` + * `credentials` will have the value `"deadbeef12346"` + """ + + scheme: Annotated[ + str, + Doc( + """ + The HTTP authorization scheme extracted from the header value. + """ + ), + ] + credentials: Annotated[ + str, + Doc( + """ + The HTTP authorization credentials extracted from the header value. + """ + ), + ] + + +class HTTPBase(SecurityBase): + def __init__( + self, + *, + scheme: str, + scheme_name: Optional[str] = None, + description: Optional[str] = None, + auto_error: bool = True, + ): + self.model = HTTPBaseModel(scheme=scheme, description=description) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__( + self, request: Request + ) -> Optional[HTTPAuthorizationCredentials]: + authorization = request.headers.get("Authorization") + scheme, credentials = get_authorization_scheme_param(authorization) + if not (authorization and scheme and credentials): + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, detail="Not authenticated" + ) + else: + return None + return HTTPAuthorizationCredentials(scheme=scheme, credentials=credentials) + + +class HTTPBasic(HTTPBase): + """ + HTTP Basic authentication. + + ## Usage + + Create an instance object and use that object as the dependency in `Depends()`. + + The dependency result will be an `HTTPBasicCredentials` object containing the + `username` and the `password`. + + Read more about it in the + [FastAPI docs for HTTP Basic Auth](https://fastapi.tiangolo.com/advanced/security/http-basic-auth/). + + ## Example + + ```python + from typing import Annotated + + from fastapi import Depends, FastAPI + from fastapi.security import HTTPBasic, HTTPBasicCredentials + + app = FastAPI() + + security = HTTPBasic() + + + @app.get("/users/me") + def read_current_user(credentials: Annotated[HTTPBasicCredentials, Depends(security)]): + return {"username": credentials.username, "password": credentials.password} + ``` + """ + + def __init__( + self, + *, + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + realm: Annotated[ + Optional[str], + Doc( + """ + HTTP Basic authentication realm. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if the HTTP Basic authentication is not provided (a + header), `HTTPBasic` will automatically cancel the request and send the + client an error. + + If `auto_error` is set to `False`, when the HTTP Basic authentication + is not available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, in HTTP Basic + authentication or in an HTTP Bearer token). + """ + ), + ] = True, + ): + self.model = HTTPBaseModel(scheme="basic", description=description) + self.scheme_name = scheme_name or self.__class__.__name__ + self.realm = realm + self.auto_error = auto_error + + async def __call__( # type: ignore + self, request: Request + ) -> Optional[HTTPBasicCredentials]: + authorization = request.headers.get("Authorization") + scheme, param = get_authorization_scheme_param(authorization) + if self.realm: + unauthorized_headers = {"WWW-Authenticate": f'Basic realm="{self.realm}"'} + else: + unauthorized_headers = {"WWW-Authenticate": "Basic"} + if not authorization or scheme.lower() != "basic": + if self.auto_error: + raise HTTPException( + status_code=HTTP_401_UNAUTHORIZED, + detail="Not authenticated", + headers=unauthorized_headers, + ) + else: + return None + invalid_user_credentials_exc = HTTPException( + status_code=HTTP_401_UNAUTHORIZED, + detail="Invalid authentication credentials", + headers=unauthorized_headers, + ) + try: + data = b64decode(param).decode("ascii") + except (ValueError, UnicodeDecodeError, binascii.Error): + raise invalid_user_credentials_exc # noqa: B904 + username, separator, password = data.partition(":") + if not separator: + raise invalid_user_credentials_exc + return HTTPBasicCredentials(username=username, password=password) + + +class HTTPBearer(HTTPBase): + """ + HTTP Bearer token authentication. + + ## Usage + + Create an instance object and use that object as the dependency in `Depends()`. + + The dependency result will be an `HTTPAuthorizationCredentials` object containing + the `scheme` and the `credentials`. + + ## Example + + ```python + from typing import Annotated + + from fastapi import Depends, FastAPI + from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer + + app = FastAPI() + + security = HTTPBearer() + + + @app.get("/users/me") + def read_current_user( + credentials: Annotated[HTTPAuthorizationCredentials, Depends(security)] + ): + return {"scheme": credentials.scheme, "credentials": credentials.credentials} + ``` + """ + + def __init__( + self, + *, + bearerFormat: Annotated[Optional[str], Doc("Bearer token format.")] = None, + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if the HTTP Bearer token is not provided (in an + `Authorization` header), `HTTPBearer` will automatically cancel the + request and send the client an error. + + If `auto_error` is set to `False`, when the HTTP Bearer token + is not available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, in an HTTP + Bearer token or in a cookie). + """ + ), + ] = True, + ): + self.model = HTTPBearerModel(bearerFormat=bearerFormat, description=description) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__( + self, request: Request + ) -> Optional[HTTPAuthorizationCredentials]: + authorization = request.headers.get("Authorization") + scheme, credentials = get_authorization_scheme_param(authorization) + if not (authorization and scheme and credentials): + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, detail="Not authenticated" + ) + else: + return None + if scheme.lower() != "bearer": + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, + detail="Invalid authentication credentials", + ) + else: + return None + return HTTPAuthorizationCredentials(scheme=scheme, credentials=credentials) + + +class HTTPDigest(HTTPBase): + """ + HTTP Digest authentication. + + ## Usage + + Create an instance object and use that object as the dependency in `Depends()`. + + The dependency result will be an `HTTPAuthorizationCredentials` object containing + the `scheme` and the `credentials`. + + ## Example + + ```python + from typing import Annotated + + from fastapi import Depends, FastAPI + from fastapi.security import HTTPAuthorizationCredentials, HTTPDigest + + app = FastAPI() + + security = HTTPDigest() + + + @app.get("/users/me") + def read_current_user( + credentials: Annotated[HTTPAuthorizationCredentials, Depends(security)] + ): + return {"scheme": credentials.scheme, "credentials": credentials.credentials} + ``` + """ + + def __init__( + self, + *, + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if the HTTP Digest is not provided, `HTTPDigest` will + automatically cancel the request and send the client an error. + + If `auto_error` is set to `False`, when the HTTP Digest is not + available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, in HTTP + Digest or in a cookie). + """ + ), + ] = True, + ): + self.model = HTTPBaseModel(scheme="digest", description=description) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__( + self, request: Request + ) -> Optional[HTTPAuthorizationCredentials]: + authorization = request.headers.get("Authorization") + scheme, credentials = get_authorization_scheme_param(authorization) + if not (authorization and scheme and credentials): + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, detail="Not authenticated" + ) + else: + return None + if scheme.lower() != "digest": + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, + detail="Invalid authentication credentials", + ) + else: + return None + return HTTPAuthorizationCredentials(scheme=scheme, credentials=credentials) diff --git a/.venv/Lib/site-packages/fastapi/security/oauth2.py b/.venv/Lib/site-packages/fastapi/security/oauth2.py new file mode 100644 index 0000000..5ffad59 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/security/oauth2.py @@ -0,0 +1,638 @@ +from typing import Any, Dict, List, Optional, Union, cast + +from fastapi.exceptions import HTTPException +from fastapi.openapi.models import OAuth2 as OAuth2Model +from fastapi.openapi.models import OAuthFlows as OAuthFlowsModel +from fastapi.param_functions import Form +from fastapi.security.base import SecurityBase +from fastapi.security.utils import get_authorization_scheme_param +from starlette.requests import Request +from starlette.status import HTTP_401_UNAUTHORIZED, HTTP_403_FORBIDDEN + +# TODO: import from typing when deprecating Python 3.9 +from typing_extensions import Annotated, Doc + + +class OAuth2PasswordRequestForm: + """ + This is a dependency class to collect the `username` and `password` as form data + for an OAuth2 password flow. + + The OAuth2 specification dictates that for a password flow the data should be + collected using form data (instead of JSON) and that it should have the specific + fields `username` and `password`. + + All the initialization parameters are extracted from the request. + + Read more about it in the + [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/). + + ## Example + + ```python + from typing import Annotated + + from fastapi import Depends, FastAPI + from fastapi.security import OAuth2PasswordRequestForm + + app = FastAPI() + + + @app.post("/login") + def login(form_data: Annotated[OAuth2PasswordRequestForm, Depends()]): + data = {} + data["scopes"] = [] + for scope in form_data.scopes: + data["scopes"].append(scope) + if form_data.client_id: + data["client_id"] = form_data.client_id + if form_data.client_secret: + data["client_secret"] = form_data.client_secret + return data + ``` + + Note that for OAuth2 the scope `items:read` is a single scope in an opaque string. + You could have custom internal logic to separate it by colon characters (`:`) or + similar, and get the two parts `items` and `read`. Many applications do that to + group and organize permissions, you could do it as well in your application, just + know that that it is application specific, it's not part of the specification. + """ + + def __init__( + self, + *, + grant_type: Annotated[ + Union[str, None], + Form(pattern="^password$"), + Doc( + """ + The OAuth2 spec says it is required and MUST be the fixed string + "password". Nevertheless, this dependency class is permissive and + allows not passing it. If you want to enforce it, use instead the + `OAuth2PasswordRequestFormStrict` dependency. + """ + ), + ] = None, + username: Annotated[ + str, + Form(), + Doc( + """ + `username` string. The OAuth2 spec requires the exact field name + `username`. + """ + ), + ], + password: Annotated[ + str, + Form(), + Doc( + """ + `password` string. The OAuth2 spec requires the exact field name + `password". + """ + ), + ], + scope: Annotated[ + str, + Form(), + Doc( + """ + A single string with actually several scopes separated by spaces. Each + scope is also a string. + + For example, a single string with: + + ```python + "items:read items:write users:read profile openid" + ```` + + would represent the scopes: + + * `items:read` + * `items:write` + * `users:read` + * `profile` + * `openid` + """ + ), + ] = "", + client_id: Annotated[ + Union[str, None], + Form(), + Doc( + """ + If there's a `client_id`, it can be sent as part of the form fields. + But the OAuth2 specification recommends sending the `client_id` and + `client_secret` (if any) using HTTP Basic auth. + """ + ), + ] = None, + client_secret: Annotated[ + Union[str, None], + Form(), + Doc( + """ + If there's a `client_password` (and a `client_id`), they can be sent + as part of the form fields. But the OAuth2 specification recommends + sending the `client_id` and `client_secret` (if any) using HTTP Basic + auth. + """ + ), + ] = None, + ): + self.grant_type = grant_type + self.username = username + self.password = password + self.scopes = scope.split() + self.client_id = client_id + self.client_secret = client_secret + + +class OAuth2PasswordRequestFormStrict(OAuth2PasswordRequestForm): + """ + This is a dependency class to collect the `username` and `password` as form data + for an OAuth2 password flow. + + The OAuth2 specification dictates that for a password flow the data should be + collected using form data (instead of JSON) and that it should have the specific + fields `username` and `password`. + + All the initialization parameters are extracted from the request. + + The only difference between `OAuth2PasswordRequestFormStrict` and + `OAuth2PasswordRequestForm` is that `OAuth2PasswordRequestFormStrict` requires the + client to send the form field `grant_type` with the value `"password"`, which + is required in the OAuth2 specification (it seems that for no particular reason), + while for `OAuth2PasswordRequestForm` `grant_type` is optional. + + Read more about it in the + [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/). + + ## Example + + ```python + from typing import Annotated + + from fastapi import Depends, FastAPI + from fastapi.security import OAuth2PasswordRequestForm + + app = FastAPI() + + + @app.post("/login") + def login(form_data: Annotated[OAuth2PasswordRequestFormStrict, Depends()]): + data = {} + data["scopes"] = [] + for scope in form_data.scopes: + data["scopes"].append(scope) + if form_data.client_id: + data["client_id"] = form_data.client_id + if form_data.client_secret: + data["client_secret"] = form_data.client_secret + return data + ``` + + Note that for OAuth2 the scope `items:read` is a single scope in an opaque string. + You could have custom internal logic to separate it by colon characters (`:`) or + similar, and get the two parts `items` and `read`. Many applications do that to + group and organize permissions, you could do it as well in your application, just + know that that it is application specific, it's not part of the specification. + + + grant_type: the OAuth2 spec says it is required and MUST be the fixed string "password". + This dependency is strict about it. If you want to be permissive, use instead the + OAuth2PasswordRequestForm dependency class. + username: username string. The OAuth2 spec requires the exact field name "username". + password: password string. The OAuth2 spec requires the exact field name "password". + scope: Optional string. Several scopes (each one a string) separated by spaces. E.g. + "items:read items:write users:read profile openid" + client_id: optional string. OAuth2 recommends sending the client_id and client_secret (if any) + using HTTP Basic auth, as: client_id:client_secret + client_secret: optional string. OAuth2 recommends sending the client_id and client_secret (if any) + using HTTP Basic auth, as: client_id:client_secret + """ + + def __init__( + self, + grant_type: Annotated[ + str, + Form(pattern="^password$"), + Doc( + """ + The OAuth2 spec says it is required and MUST be the fixed string + "password". This dependency is strict about it. If you want to be + permissive, use instead the `OAuth2PasswordRequestForm` dependency + class. + """ + ), + ], + username: Annotated[ + str, + Form(), + Doc( + """ + `username` string. The OAuth2 spec requires the exact field name + `username`. + """ + ), + ], + password: Annotated[ + str, + Form(), + Doc( + """ + `password` string. The OAuth2 spec requires the exact field name + `password". + """ + ), + ], + scope: Annotated[ + str, + Form(), + Doc( + """ + A single string with actually several scopes separated by spaces. Each + scope is also a string. + + For example, a single string with: + + ```python + "items:read items:write users:read profile openid" + ```` + + would represent the scopes: + + * `items:read` + * `items:write` + * `users:read` + * `profile` + * `openid` + """ + ), + ] = "", + client_id: Annotated[ + Union[str, None], + Form(), + Doc( + """ + If there's a `client_id`, it can be sent as part of the form fields. + But the OAuth2 specification recommends sending the `client_id` and + `client_secret` (if any) using HTTP Basic auth. + """ + ), + ] = None, + client_secret: Annotated[ + Union[str, None], + Form(), + Doc( + """ + If there's a `client_password` (and a `client_id`), they can be sent + as part of the form fields. But the OAuth2 specification recommends + sending the `client_id` and `client_secret` (if any) using HTTP Basic + auth. + """ + ), + ] = None, + ): + super().__init__( + grant_type=grant_type, + username=username, + password=password, + scope=scope, + client_id=client_id, + client_secret=client_secret, + ) + + +class OAuth2(SecurityBase): + """ + This is the base class for OAuth2 authentication, an instance of it would be used + as a dependency. All other OAuth2 classes inherit from it and customize it for + each OAuth2 flow. + + You normally would not create a new class inheriting from it but use one of the + existing subclasses, and maybe compose them if you want to support multiple flows. + + Read more about it in the + [FastAPI docs for Security](https://fastapi.tiangolo.com/tutorial/security/). + """ + + def __init__( + self, + *, + flows: Annotated[ + Union[OAuthFlowsModel, Dict[str, Dict[str, Any]]], + Doc( + """ + The dictionary of OAuth2 flows. + """ + ), + ] = OAuthFlowsModel(), + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if no HTTP Authorization header is provided, required for + OAuth2 authentication, it will automatically cancel the request and + send the client an error. + + If `auto_error` is set to `False`, when the HTTP Authorization header + is not available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, with OAuth2 + or in a cookie). + """ + ), + ] = True, + ): + self.model = OAuth2Model( + flows=cast(OAuthFlowsModel, flows), description=description + ) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__(self, request: Request) -> Optional[str]: + authorization = request.headers.get("Authorization") + if not authorization: + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, detail="Not authenticated" + ) + else: + return None + return authorization + + +class OAuth2PasswordBearer(OAuth2): + """ + OAuth2 flow for authentication using a bearer token obtained with a password. + An instance of it would be used as a dependency. + + Read more about it in the + [FastAPI docs for Simple OAuth2 with Password and Bearer](https://fastapi.tiangolo.com/tutorial/security/simple-oauth2/). + """ + + def __init__( + self, + tokenUrl: Annotated[ + str, + Doc( + """ + The URL to obtain the OAuth2 token. This would be the *path operation* + that has `OAuth2PasswordRequestForm` as a dependency. + """ + ), + ], + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + scopes: Annotated[ + Optional[Dict[str, str]], + Doc( + """ + The OAuth2 scopes that would be required by the *path operations* that + use this dependency. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if no HTTP Authorization header is provided, required for + OAuth2 authentication, it will automatically cancel the request and + send the client an error. + + If `auto_error` is set to `False`, when the HTTP Authorization header + is not available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, with OAuth2 + or in a cookie). + """ + ), + ] = True, + ): + if not scopes: + scopes = {} + flows = OAuthFlowsModel( + password=cast(Any, {"tokenUrl": tokenUrl, "scopes": scopes}) + ) + super().__init__( + flows=flows, + scheme_name=scheme_name, + description=description, + auto_error=auto_error, + ) + + async def __call__(self, request: Request) -> Optional[str]: + authorization = request.headers.get("Authorization") + scheme, param = get_authorization_scheme_param(authorization) + if not authorization or scheme.lower() != "bearer": + if self.auto_error: + raise HTTPException( + status_code=HTTP_401_UNAUTHORIZED, + detail="Not authenticated", + headers={"WWW-Authenticate": "Bearer"}, + ) + else: + return None + return param + + +class OAuth2AuthorizationCodeBearer(OAuth2): + """ + OAuth2 flow for authentication using a bearer token obtained with an OAuth2 code + flow. An instance of it would be used as a dependency. + """ + + def __init__( + self, + authorizationUrl: str, + tokenUrl: Annotated[ + str, + Doc( + """ + The URL to obtain the OAuth2 token. + """ + ), + ], + refreshUrl: Annotated[ + Optional[str], + Doc( + """ + The URL to refresh the token and obtain a new one. + """ + ), + ] = None, + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + scopes: Annotated[ + Optional[Dict[str, str]], + Doc( + """ + The OAuth2 scopes that would be required by the *path operations* that + use this dependency. + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if no HTTP Authorization header is provided, required for + OAuth2 authentication, it will automatically cancel the request and + send the client an error. + + If `auto_error` is set to `False`, when the HTTP Authorization header + is not available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, with OAuth2 + or in a cookie). + """ + ), + ] = True, + ): + if not scopes: + scopes = {} + flows = OAuthFlowsModel( + authorizationCode=cast( + Any, + { + "authorizationUrl": authorizationUrl, + "tokenUrl": tokenUrl, + "refreshUrl": refreshUrl, + "scopes": scopes, + }, + ) + ) + super().__init__( + flows=flows, + scheme_name=scheme_name, + description=description, + auto_error=auto_error, + ) + + async def __call__(self, request: Request) -> Optional[str]: + authorization = request.headers.get("Authorization") + scheme, param = get_authorization_scheme_param(authorization) + if not authorization or scheme.lower() != "bearer": + if self.auto_error: + raise HTTPException( + status_code=HTTP_401_UNAUTHORIZED, + detail="Not authenticated", + headers={"WWW-Authenticate": "Bearer"}, + ) + else: + return None # pragma: nocover + return param + + +class SecurityScopes: + """ + This is a special class that you can define in a parameter in a dependency to + obtain the OAuth2 scopes required by all the dependencies in the same chain. + + This way, multiple dependencies can have different scopes, even when used in the + same *path operation*. And with this, you can access all the scopes required in + all those dependencies in a single place. + + Read more about it in the + [FastAPI docs for OAuth2 scopes](https://fastapi.tiangolo.com/advanced/security/oauth2-scopes/). + """ + + def __init__( + self, + scopes: Annotated[ + Optional[List[str]], + Doc( + """ + This will be filled by FastAPI. + """ + ), + ] = None, + ): + self.scopes: Annotated[ + List[str], + Doc( + """ + The list of all the scopes required by dependencies. + """ + ), + ] = scopes or [] + self.scope_str: Annotated[ + str, + Doc( + """ + All the scopes required by all the dependencies in a single string + separated by spaces, as defined in the OAuth2 specification. + """ + ), + ] = " ".join(self.scopes) diff --git a/.venv/Lib/site-packages/fastapi/security/open_id_connect_url.py b/.venv/Lib/site-packages/fastapi/security/open_id_connect_url.py new file mode 100644 index 0000000..c8cceb9 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/security/open_id_connect_url.py @@ -0,0 +1,84 @@ +from typing import Optional + +from fastapi.openapi.models import OpenIdConnect as OpenIdConnectModel +from fastapi.security.base import SecurityBase +from starlette.exceptions import HTTPException +from starlette.requests import Request +from starlette.status import HTTP_403_FORBIDDEN +from typing_extensions import Annotated, Doc + + +class OpenIdConnect(SecurityBase): + """ + OpenID Connect authentication class. An instance of it would be used as a + dependency. + """ + + def __init__( + self, + *, + openIdConnectUrl: Annotated[ + str, + Doc( + """ + The OpenID Connect URL. + """ + ), + ], + scheme_name: Annotated[ + Optional[str], + Doc( + """ + Security scheme name. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + description: Annotated[ + Optional[str], + Doc( + """ + Security scheme description. + + It will be included in the generated OpenAPI (e.g. visible at `/docs`). + """ + ), + ] = None, + auto_error: Annotated[ + bool, + Doc( + """ + By default, if no HTTP Authorization header is provided, required for + OpenID Connect authentication, it will automatically cancel the request + and send the client an error. + + If `auto_error` is set to `False`, when the HTTP Authorization header + is not available, instead of erroring out, the dependency result will + be `None`. + + This is useful when you want to have optional authentication. + + It is also useful when you want to have authentication that can be + provided in one of multiple optional ways (for example, with OpenID + Connect or in a cookie). + """ + ), + ] = True, + ): + self.model = OpenIdConnectModel( + openIdConnectUrl=openIdConnectUrl, description=description + ) + self.scheme_name = scheme_name or self.__class__.__name__ + self.auto_error = auto_error + + async def __call__(self, request: Request) -> Optional[str]: + authorization = request.headers.get("Authorization") + if not authorization: + if self.auto_error: + raise HTTPException( + status_code=HTTP_403_FORBIDDEN, detail="Not authenticated" + ) + else: + return None + return authorization diff --git a/.venv/Lib/site-packages/fastapi/security/utils.py b/.venv/Lib/site-packages/fastapi/security/utils.py new file mode 100644 index 0000000..fa7a450 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/security/utils.py @@ -0,0 +1,10 @@ +from typing import Optional, Tuple + + +def get_authorization_scheme_param( + authorization_header_value: Optional[str], +) -> Tuple[str, str]: + if not authorization_header_value: + return "", "" + scheme, _, param = authorization_header_value.partition(" ") + return scheme, param diff --git a/.venv/Lib/site-packages/fastapi/staticfiles.py b/.venv/Lib/site-packages/fastapi/staticfiles.py new file mode 100644 index 0000000..299015d --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/staticfiles.py @@ -0,0 +1 @@ +from starlette.staticfiles import StaticFiles as StaticFiles # noqa diff --git a/.venv/Lib/site-packages/fastapi/templating.py b/.venv/Lib/site-packages/fastapi/templating.py new file mode 100644 index 0000000..0cb8684 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/templating.py @@ -0,0 +1 @@ +from starlette.templating import Jinja2Templates as Jinja2Templates # noqa diff --git a/.venv/Lib/site-packages/fastapi/testclient.py b/.venv/Lib/site-packages/fastapi/testclient.py new file mode 100644 index 0000000..4012406 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/testclient.py @@ -0,0 +1 @@ +from starlette.testclient import TestClient as TestClient # noqa diff --git a/.venv/Lib/site-packages/fastapi/types.py b/.venv/Lib/site-packages/fastapi/types.py new file mode 100644 index 0000000..3205654 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/types.py @@ -0,0 +1,10 @@ +import types +from enum import Enum +from typing import Any, Callable, Dict, Set, Type, TypeVar, Union + +from pydantic import BaseModel + +DecoratedCallable = TypeVar("DecoratedCallable", bound=Callable[..., Any]) +UnionType = getattr(types, "UnionType", Union) +ModelNameMap = Dict[Union[Type[BaseModel], Type[Enum]], str] +IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]] diff --git a/.venv/Lib/site-packages/fastapi/utils.py b/.venv/Lib/site-packages/fastapi/utils.py new file mode 100644 index 0000000..4c7350f --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/utils.py @@ -0,0 +1,220 @@ +import re +import warnings +from dataclasses import is_dataclass +from typing import ( + TYPE_CHECKING, + Any, + Dict, + MutableMapping, + Optional, + Set, + Type, + Union, + cast, +) +from weakref import WeakKeyDictionary + +import fastapi +from fastapi._compat import ( + PYDANTIC_V2, + BaseConfig, + ModelField, + PydanticSchemaGenerationError, + Undefined, + UndefinedType, + Validator, + lenient_issubclass, +) +from fastapi.datastructures import DefaultPlaceholder, DefaultType +from pydantic import BaseModel, create_model +from pydantic.fields import FieldInfo +from typing_extensions import Literal + +if TYPE_CHECKING: # pragma: nocover + from .routing import APIRoute + +# Cache for `create_cloned_field` +_CLONED_TYPES_CACHE: MutableMapping[Type[BaseModel], Type[BaseModel]] = ( + WeakKeyDictionary() +) + + +def is_body_allowed_for_status_code(status_code: Union[int, str, None]) -> bool: + if status_code is None: + return True + # Ref: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#patterned-fields-1 + if status_code in { + "default", + "1XX", + "2XX", + "3XX", + "4XX", + "5XX", + }: + return True + current_status_code = int(status_code) + return not (current_status_code < 200 or current_status_code in {204, 205, 304}) + + +def get_path_param_names(path: str) -> Set[str]: + return set(re.findall("{(.*?)}", path)) + + +def create_model_field( + name: str, + type_: Any, + class_validators: Optional[Dict[str, Validator]] = None, + default: Optional[Any] = Undefined, + required: Union[bool, UndefinedType] = Undefined, + model_config: Type[BaseConfig] = BaseConfig, + field_info: Optional[FieldInfo] = None, + alias: Optional[str] = None, + mode: Literal["validation", "serialization"] = "validation", +) -> ModelField: + class_validators = class_validators or {} + if PYDANTIC_V2: + field_info = field_info or FieldInfo( + annotation=type_, default=default, alias=alias + ) + else: + field_info = field_info or FieldInfo() + kwargs = {"name": name, "field_info": field_info} + if PYDANTIC_V2: + kwargs.update({"mode": mode}) + else: + kwargs.update( + { + "type_": type_, + "class_validators": class_validators, + "default": default, + "required": required, + "model_config": model_config, + "alias": alias, + } + ) + try: + return ModelField(**kwargs) # type: ignore[arg-type] + except (RuntimeError, PydanticSchemaGenerationError): + raise fastapi.exceptions.FastAPIError( + "Invalid args for response field! Hint: " + f"check that {type_} is a valid Pydantic field type. " + "If you are using a return type annotation that is not a valid Pydantic " + "field (e.g. Union[Response, dict, None]) you can disable generating the " + "response model from the type annotation with the path operation decorator " + "parameter response_model=None. Read more: " + "https://fastapi.tiangolo.com/tutorial/response-model/" + ) from None + + +def create_cloned_field( + field: ModelField, + *, + cloned_types: Optional[MutableMapping[Type[BaseModel], Type[BaseModel]]] = None, +) -> ModelField: + if PYDANTIC_V2: + return field + # cloned_types caches already cloned types to support recursive models and improve + # performance by avoiding unnecessary cloning + if cloned_types is None: + cloned_types = _CLONED_TYPES_CACHE + + original_type = field.type_ + if is_dataclass(original_type) and hasattr(original_type, "__pydantic_model__"): + original_type = original_type.__pydantic_model__ + use_type = original_type + if lenient_issubclass(original_type, BaseModel): + original_type = cast(Type[BaseModel], original_type) + use_type = cloned_types.get(original_type) + if use_type is None: + use_type = create_model(original_type.__name__, __base__=original_type) + cloned_types[original_type] = use_type + for f in original_type.__fields__.values(): + use_type.__fields__[f.name] = create_cloned_field( + f, cloned_types=cloned_types + ) + new_field = create_model_field(name=field.name, type_=use_type) + new_field.has_alias = field.has_alias # type: ignore[attr-defined] + new_field.alias = field.alias # type: ignore[misc] + new_field.class_validators = field.class_validators # type: ignore[attr-defined] + new_field.default = field.default # type: ignore[misc] + new_field.required = field.required # type: ignore[misc] + new_field.model_config = field.model_config # type: ignore[attr-defined] + new_field.field_info = field.field_info + new_field.allow_none = field.allow_none # type: ignore[attr-defined] + new_field.validate_always = field.validate_always # type: ignore[attr-defined] + if field.sub_fields: # type: ignore[attr-defined] + new_field.sub_fields = [ # type: ignore[attr-defined] + create_cloned_field(sub_field, cloned_types=cloned_types) + for sub_field in field.sub_fields # type: ignore[attr-defined] + ] + if field.key_field: # type: ignore[attr-defined] + new_field.key_field = create_cloned_field( # type: ignore[attr-defined] + field.key_field, # type: ignore[attr-defined] + cloned_types=cloned_types, + ) + new_field.validators = field.validators # type: ignore[attr-defined] + new_field.pre_validators = field.pre_validators # type: ignore[attr-defined] + new_field.post_validators = field.post_validators # type: ignore[attr-defined] + new_field.parse_json = field.parse_json # type: ignore[attr-defined] + new_field.shape = field.shape # type: ignore[attr-defined] + new_field.populate_validators() # type: ignore[attr-defined] + return new_field + + +def generate_operation_id_for_path( + *, name: str, path: str, method: str +) -> str: # pragma: nocover + warnings.warn( + "fastapi.utils.generate_operation_id_for_path() was deprecated, " + "it is not used internally, and will be removed soon", + DeprecationWarning, + stacklevel=2, + ) + operation_id = f"{name}{path}" + operation_id = re.sub(r"\W", "_", operation_id) + operation_id = f"{operation_id}_{method.lower()}" + return operation_id + + +def generate_unique_id(route: "APIRoute") -> str: + operation_id = f"{route.name}{route.path_format}" + operation_id = re.sub(r"\W", "_", operation_id) + assert route.methods + operation_id = f"{operation_id}_{list(route.methods)[0].lower()}" + return operation_id + + +def deep_dict_update(main_dict: Dict[Any, Any], update_dict: Dict[Any, Any]) -> None: + for key, value in update_dict.items(): + if ( + key in main_dict + and isinstance(main_dict[key], dict) + and isinstance(value, dict) + ): + deep_dict_update(main_dict[key], value) + elif ( + key in main_dict + and isinstance(main_dict[key], list) + and isinstance(update_dict[key], list) + ): + main_dict[key] = main_dict[key] + update_dict[key] + else: + main_dict[key] = value + + +def get_value_or_default( + first_item: Union[DefaultPlaceholder, DefaultType], + *extra_items: Union[DefaultPlaceholder, DefaultType], +) -> Union[DefaultPlaceholder, DefaultType]: + """ + Pass items or `DefaultPlaceholder`s by descending priority. + + The first one to _not_ be a `DefaultPlaceholder` will be returned. + + Otherwise, the first item (a `DefaultPlaceholder`) will be returned. + """ + items = (first_item,) + extra_items + for item in items: + if not isinstance(item, DefaultPlaceholder): + return item + return first_item diff --git a/.venv/Lib/site-packages/fastapi/websockets.py b/.venv/Lib/site-packages/fastapi/websockets.py new file mode 100644 index 0000000..55a4ac4 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi/websockets.py @@ -0,0 +1,3 @@ +from starlette.websockets import WebSocket as WebSocket # noqa +from starlette.websockets import WebSocketDisconnect as WebSocketDisconnect # noqa +from starlette.websockets import WebSocketState as WebSocketState # noqa diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/AUTHORS b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/AUTHORS new file mode 100644 index 0000000..42a5c22 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/AUTHORS @@ -0,0 +1,51 @@ +Original Authors +---------------- +* Armin Rigo +* Christian Tismer + +Contributors +------------ +* Al Stone +* Alexander Schmidt +* Alexey Borzenkov +* Andreas Schwab +* Armin Ronacher +* Bin Wang +* Bob Ippolito +* ChangBo Guo +* Christoph Gohlke +* Denis Bilenko +* Dirk Mueller +* Donovan Preston +* Fantix King +* Floris Bruynooghe +* Fredrik Fornwall +* Gerd Woetzel +* Giel van Schijndel +* Gökhan Karabulut +* Gustavo Niemeyer +* Guy Rozendorn +* Hye-Shik Chang +* Jared Kuolt +* Jason Madden +* Josh Snyder +* Kyle Ambroff +* Laszlo Boszormenyi +* Mao Han +* Marc Abramowitz +* Marc Schlaich +* Marcin Bachry +* Matt Madison +* Matt Turner +* Michael Ellerman +* Michael Matz +* Ralf Schmitt +* Robie Basak +* Ronny Pfannschmidt +* Samual M. Rushing +* Tony Bowles +* Tony Breeds +* Trevor Bowen +* Tulio Magno Quites Machado Filho +* Ulrich Weigand +* Victor Stinner diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/INSTALLER b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE new file mode 100644 index 0000000..b73a4a1 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE @@ -0,0 +1,30 @@ +The following files are derived from Stackless Python and are subject to the +same license as Stackless Python: + + src/greenlet/slp_platformselect.h + files in src/greenlet/platform/ directory + +See LICENSE.PSF and http://www.stackless.com/ for details. + +Unless otherwise noted, the files in greenlet have been released under the +following MIT license: + +Copyright (c) Armin Rigo, Christian Tismer and 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/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE.PSF b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE.PSF new file mode 100644 index 0000000..d3b509a --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/LICENSE.PSF @@ -0,0 +1,47 @@ +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 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. diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/METADATA b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/METADATA new file mode 100644 index 0000000..1529410 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/METADATA @@ -0,0 +1,103 @@ +Metadata-Version: 2.1 +Name: greenlet +Version: 3.1.1 +Summary: Lightweight in-process concurrent programming +Home-page: https://greenlet.readthedocs.io/ +Author: Alexey Borzenkov +Author-email: snaury@gmail.com +Maintainer: Jason Madden +Maintainer-email: jason@seecoresoftware.com +License: MIT License +Project-URL: Bug Tracker, https://github.com/python-greenlet/greenlet/issues +Project-URL: Source Code, https://github.com/python-greenlet/greenlet/ +Project-URL: Documentation, https://greenlet.readthedocs.io/ +Keywords: greenlet coroutine concurrency threads cooperative +Platform: any +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Natural Language :: English +Classifier: Programming Language :: C +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +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: Operating System :: OS Independent +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Requires-Python: >=3.7 +Description-Content-Type: text/x-rst +License-File: LICENSE +License-File: LICENSE.PSF +License-File: AUTHORS +Provides-Extra: docs +Requires-Dist: Sphinx ; extra == 'docs' +Requires-Dist: furo ; extra == 'docs' +Provides-Extra: test +Requires-Dist: objgraph ; extra == 'test' +Requires-Dist: psutil ; extra == 'test' + +.. This file is included into docs/history.rst + + +Greenlets are lightweight coroutines for in-process concurrent +programming. + +The "greenlet" package is a spin-off of `Stackless`_, a version of +CPython that supports micro-threads called "tasklets". Tasklets run +pseudo-concurrently (typically in a single or a few OS-level threads) +and are synchronized with data exchanges on "channels". + +A "greenlet", on the other hand, is a still more primitive notion of +micro-thread with no implicit scheduling; coroutines, in other words. +This is useful when you want to control exactly when your code runs. +You can build custom scheduled micro-threads on top of greenlet; +however, it seems that greenlets are useful on their own as a way to +make advanced control flow structures. For example, we can recreate +generators; the difference with Python's own generators is that our +generators can call nested functions and the nested functions can +yield values too. (Additionally, you don't need a "yield" keyword. See +the example in `test_generator.py +`_). + +Greenlets are provided as a C extension module for the regular unmodified +interpreter. + +.. _`Stackless`: http://www.stackless.com + + +Who is using Greenlet? +====================== + +There are several libraries that use Greenlet as a more flexible +alternative to Python's built in coroutine support: + + - `Concurrence`_ + - `Eventlet`_ + - `Gevent`_ + +.. _Concurrence: http://opensource.hyves.org/concurrence/ +.. _Eventlet: http://eventlet.net/ +.. _Gevent: http://www.gevent.org/ + +Getting Greenlet +================ + +The easiest way to get Greenlet is to install it with pip:: + + pip install greenlet + + +Source code archives and binary distributions are available on the +python package index at https://pypi.org/project/greenlet + +The source code repository is hosted on github: +https://github.com/python-greenlet/greenlet + +Documentation is available on readthedocs.org: +https://greenlet.readthedocs.io diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/RECORD b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/RECORD new file mode 100644 index 0000000..01640ea --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/RECORD @@ -0,0 +1,122 @@ +../../include/site/python3.12/greenlet/greenlet.h,sha256=sz5pYRSQqedgOt2AMgxLZdTjO-qcr_JMvgiEJR9IAJ8,4755 +greenlet-3.1.1.dist-info/AUTHORS,sha256=swW28t2knVRxRkaEQNZtO7MP9Sgnompb7B6cNgJM8Gk,849 +greenlet-3.1.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +greenlet-3.1.1.dist-info/LICENSE,sha256=dpgx1uXfrywggC-sz_H6-0wgJd2PYlPfpH_K1Z1NCXk,1434 +greenlet-3.1.1.dist-info/LICENSE.PSF,sha256=5f88I8EQ5JTNfXNsEP2W1GJFe6_soxCEDbZScpjH1Gs,2424 +greenlet-3.1.1.dist-info/METADATA,sha256=98pubBCLPmBVc3KVRmetjFyd8jA9e9BXhD_07cAcccc,3933 +greenlet-3.1.1.dist-info/RECORD,, +greenlet-3.1.1.dist-info/WHEEL,sha256=3vidnDuZ-QSnHIxLhNbI1gIM-KgyEcMHuZuv1mWPd_Q,101 +greenlet-3.1.1.dist-info/top_level.txt,sha256=YSnRsCRoO61JGlP57o8iKL6rdLWDWuiyKD8ekpWUsDc,9 +greenlet/CObjects.cpp,sha256=OPej1bWBgc4sRrTRQ2aFFML9pzDYKlKhlJSjsI0X_eU,3508 +greenlet/PyGreenlet.cpp,sha256=ogWsQ5VhSdItWRLLpWOgSuqYuM3QwQ4cVCxOQIgHx6E,23441 +greenlet/PyGreenlet.hpp,sha256=2ZQlOxYNoy7QwD7mppFoOXe_At56NIsJ0eNsE_hoSsw,1463 +greenlet/PyGreenletUnswitchable.cpp,sha256=PQE0fSZa_IOyUM44IESHkJoD2KtGW3dkhkmZSYY3WHs,4375 +greenlet/PyModule.cpp,sha256=J2TH06dGcNEarioS6NbWXkdME8hJY05XVbdqLrfO5w4,8587 +greenlet/TBrokenGreenlet.cpp,sha256=smN26uC7ahAbNYiS10rtWPjCeTG4jevM8siA2sjJiXg,1021 +greenlet/TExceptionState.cpp,sha256=U7Ctw9fBdNraS0d174MoQW7bN-ae209Ta0JuiKpcpVI,1359 +greenlet/TGreenlet.cpp,sha256=HGYGKpmKYqQ842tASW-QaaV8wua4a5XV_quYKPDsV_Y,25731 +greenlet/TGreenlet.hpp,sha256=mMHcb_rSuozdDiGJjX3GgyYkWgVM4kuO1UgbUP84BlU,27869 +greenlet/TGreenletGlobals.cpp,sha256=YyEmDjKf1g32bsL-unIUScFLnnA1fzLWf2gOMd-D0Zw,3264 +greenlet/TMainGreenlet.cpp,sha256=fvgb8HHB-FVTPEKjR1s_ifCZSpp5D5YQByik0CnIABg,3276 +greenlet/TPythonState.cpp,sha256=FxRdi76lTGXaQKWwkq82VaCfIRdF2Z-fh-TlRTMjYqg,15359 +greenlet/TStackState.cpp,sha256=V444I8Jj9DhQz-9leVW_9dtiSRjaE1NMlgDG02Xxq-Y,7381 +greenlet/TThreadState.hpp,sha256=2Jgg7DtGggMYR_x3CLAvAFf1mIdIDtQvSSItcdmX4ZQ,19131 +greenlet/TThreadStateCreator.hpp,sha256=uYTexDWooXSSgUc5uh-Mhm5BQi3-kR6CqpizvNynBFQ,2610 +greenlet/TThreadStateDestroy.cpp,sha256=wt7lQwLI0mi_JtnZB_jB4bUmfCa5b6nQhA7XOmnI1yk,9568 +greenlet/TUserGreenlet.cpp,sha256=uemg0lwKXtYB0yzmvyYdIIAsKnNkifXM1OJ2OlrFP1A,23553 +greenlet/__init__.py,sha256=OOmvT6_vn_SekdPzkj4qm6hjfikXMmdNZYDmGTOaRNo,1723 +greenlet/__pycache__/__init__.cpython-312.pyc,, +greenlet/_greenlet.cp312-win_amd64.pyd,sha256=JFaHsWu81i5kpGz46CSTSo6rBwIsDU6bjcN12nzBT9c,219136 +greenlet/greenlet.cpp,sha256=WdItb1yWL9WNsTqJNf0Iw8ZwDHD49pkDP0rIRGBg2pw,10996 +greenlet/greenlet.h,sha256=sz5pYRSQqedgOt2AMgxLZdTjO-qcr_JMvgiEJR9IAJ8,4755 +greenlet/greenlet_allocator.hpp,sha256=kxyWW4Qdwlrc7ufgdb5vd6Y7jhauQ699Kod0mqiO1iM,1582 +greenlet/greenlet_compiler_compat.hpp,sha256=nRxpLN9iNbnLVyFDeVmOwyeeNm6scQrOed1l7JQYMCM,4346 +greenlet/greenlet_cpython_add_pending.hpp,sha256=apAwIhGlgYrnYn03zWL6Sxy68kltDeb1e0QupZfb3DQ,6043 +greenlet/greenlet_cpython_compat.hpp,sha256=L_jig3dm2bsJWRazrhlokma2NfnwixoQ0cydshh6ce4,3964 +greenlet/greenlet_exceptions.hpp,sha256=06Bx81DtVaJTa6RtiMcV141b-XHv4ppEgVItkblcLWY,4503 +greenlet/greenlet_internal.hpp,sha256=Ajc-_09W4xWzm9XfyXHAeQAFUgKGKsnJwYsTCoNy3ns,2709 +greenlet/greenlet_refs.hpp,sha256=OnbA91yZf3QHH6-eJccvoNDAaN-pQBMMrclFU1Ot3J4,34436 +greenlet/greenlet_slp_switch.hpp,sha256=kM1QHA2iV-gH4cFyN6lfIagHQxvJZjWOVJdIxRE3TlQ,3198 +greenlet/greenlet_thread_support.hpp,sha256=XUJ6ljWjf9OYyuOILiz8e_yHvT3fbaUiHdhiPNQUV4s,867 +greenlet/platform/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +greenlet/platform/__pycache__/__init__.cpython-312.pyc,, +greenlet/platform/setup_switch_x64_masm.cmd,sha256=ZpClUJeU0ujEPSTWNSepP0W2f9XiYQKA8QKSoVou8EU,143 +greenlet/platform/switch_aarch64_gcc.h,sha256=GKC0yWNXnbK2X--X6aguRCMj2Tg7hDU1Zkl3RljDvC8,4307 +greenlet/platform/switch_alpha_unix.h,sha256=Z-SvF8JQV3oxWT8JRbL9RFu4gRFxPdJ7cviM8YayMmw,671 +greenlet/platform/switch_amd64_unix.h,sha256=EcSFCBlodEBhqhKjcJqY_5Dn_jn7pKpkJlOvp7gFXLI,2748 +greenlet/platform/switch_arm32_gcc.h,sha256=Z3KkHszdgq6uU4YN3BxvKMG2AdDnovwCCNrqGWZ1Lyo,2479 +greenlet/platform/switch_arm32_ios.h,sha256=mm5_R9aXB92hyxzFRwB71M60H6AlvHjrpTrc72Pz3l8,1892 +greenlet/platform/switch_arm64_masm.asm,sha256=4kpTtfy7rfcr8j1CpJLAK21EtZpGDAJXWRU68HEy5A8,1245 +greenlet/platform/switch_arm64_masm.obj,sha256=DmLnIB_icoEHAz1naue_pJPTZgR9ElM7-Nmztr-o9_U,746 +greenlet/platform/switch_arm64_msvc.h,sha256=RqK5MHLmXI3Q-FQ7tm32KWnbDNZKnkJdq8CR89cz640,398 +greenlet/platform/switch_csky_gcc.h,sha256=kDikyiPpewP71KoBZQO_MukDTXTXBiC7x-hF0_2DL0w,1331 +greenlet/platform/switch_loongarch64_linux.h,sha256=7M-Dhc4Q8tRbJCJhalDLwU6S9Mx8MjmN1RbTDgIvQTM,779 +greenlet/platform/switch_m68k_gcc.h,sha256=VSa6NpZhvyyvF-Q58CTIWSpEDo4FKygOyTz00whctlw,928 +greenlet/platform/switch_mips_unix.h,sha256=E0tYsqc5anDY1BhenU1l8DW-nVHC_BElzLgJw3TGtPk,1426 +greenlet/platform/switch_ppc64_aix.h,sha256=_BL0iyRr3ZA5iPlr3uk9SJ5sNRWGYLrXcZ5z-CE9anE,3860 +greenlet/platform/switch_ppc64_linux.h,sha256=0rriT5XyxPb0GqsSSn_bP9iQsnjsPbBmu0yqo5goSyQ,3815 +greenlet/platform/switch_ppc_aix.h,sha256=pHA4slEjUFP3J3SYm1TAlNPhgb2G_PAtax5cO8BEe1A,2941 +greenlet/platform/switch_ppc_linux.h,sha256=YwrlKUzxlXuiKMQqr6MFAV1bPzWnmvk6X1AqJZEpOWU,2759 +greenlet/platform/switch_ppc_macosx.h,sha256=Z6KN_ud0n6nC3ltJrNz2qtvER6vnRAVRNH9mdIDpMxY,2624 +greenlet/platform/switch_ppc_unix.h,sha256=-ZG7MSSPEA5N4qO9PQChtyEJ-Fm6qInhyZm_ZBHTtMg,2652 +greenlet/platform/switch_riscv_unix.h,sha256=Xg0wBen8Je21LWzFtLNLvUUYq6p9n_WY7AUQbiBVyyk,865 +greenlet/platform/switch_s390_unix.h,sha256=RRlGu957ybmq95qNNY4Qw1mcaoT3eBnW5KbVwu48KX8,2763 +greenlet/platform/switch_sh_gcc.h,sha256=mcRJBTu-2UBf4kZtX601qofwuDuy-Y-hnxJtrcaB7do,901 +greenlet/platform/switch_sparc_sun_gcc.h,sha256=xZish9GsMHBienUbUMsX1-ZZ-as7hs36sVhYIE3ew8Y,2797 +greenlet/platform/switch_x32_unix.h,sha256=nM98PKtzTWc1lcM7TRMUZJzskVdR1C69U1UqZRWX0GE,1509 +greenlet/platform/switch_x64_masm.asm,sha256=nu6n2sWyXuXfpPx40d9YmLfHXUc1sHgeTvX1kUzuvEM,1841 +greenlet/platform/switch_x64_masm.obj,sha256=GNtTNxYdo7idFUYsQv-mrXWgyT5EJ93-9q90lN6svtQ,1078 +greenlet/platform/switch_x64_msvc.h,sha256=LIeasyKo_vHzspdMzMHbosRhrBfKI4BkQOh4qcTHyJw,1805 +greenlet/platform/switch_x86_msvc.h,sha256=TtGOwinbFfnn6clxMNkCz8i6OmgB6kVRrShoF5iT9to,12838 +greenlet/platform/switch_x86_unix.h,sha256=VplW9H0FF0cZHw1DhJdIUs5q6YLS4cwb2nYwjF83R1s,3059 +greenlet/slp_platformselect.h,sha256=s-U-BrZ3qwwfI-6W9zWw2rb404OksZYbxYC2w5kSMXM,3841 +greenlet/tests/__init__.py,sha256=cj2-qpMXnlVRLbMLX-rPNNMVJ42ZssdxHd84NSQ3YXw,9246 +greenlet/tests/__pycache__/__init__.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_cpp_exception.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_slp_switch.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-312.pyc,, +greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-312.pyc,, +greenlet/tests/__pycache__/leakcheck.cpython-312.pyc,, +greenlet/tests/__pycache__/test_contextvars.cpython-312.pyc,, +greenlet/tests/__pycache__/test_cpp.cpython-312.pyc,, +greenlet/tests/__pycache__/test_extension_interface.cpython-312.pyc,, +greenlet/tests/__pycache__/test_gc.cpython-312.pyc,, +greenlet/tests/__pycache__/test_generator.cpython-312.pyc,, +greenlet/tests/__pycache__/test_generator_nested.cpython-312.pyc,, +greenlet/tests/__pycache__/test_greenlet.cpython-312.pyc,, +greenlet/tests/__pycache__/test_greenlet_trash.cpython-312.pyc,, +greenlet/tests/__pycache__/test_leaks.cpython-312.pyc,, +greenlet/tests/__pycache__/test_stack_saved.cpython-312.pyc,, +greenlet/tests/__pycache__/test_throw.cpython-312.pyc,, +greenlet/tests/__pycache__/test_tracing.cpython-312.pyc,, +greenlet/tests/__pycache__/test_version.cpython-312.pyc,, +greenlet/tests/__pycache__/test_weakref.cpython-312.pyc,, +greenlet/tests/_test_extension.c,sha256=vkeGA-6oeJcGILsD7oIrT1qZop2GaTOHXiNT7mcSl-0,5773 +greenlet/tests/_test_extension.cp312-win_amd64.pyd,sha256=djrk1kpwg9yqun3OBVt6Gl85whNLs3uuHMBy4NqPTEA,14336 +greenlet/tests/_test_extension_cpp.cp312-win_amd64.pyd,sha256=UKalV0Ji6FV9UFI8HX4lM-Py-BO55KBMJNsPeouv0nE,15872 +greenlet/tests/_test_extension_cpp.cpp,sha256=e0kVnaB8CCaEhE9yHtNyfqTjevsPDKKx-zgxk7PPK48,6565 +greenlet/tests/fail_clearing_run_switches.py,sha256=o433oA_nUCtOPaMEGc8VEhZIKa71imVHXFw7TsXaP8M,1263 +greenlet/tests/fail_cpp_exception.py,sha256=o_ZbipWikok8Bjc-vjiQvcb5FHh2nVW-McGKMLcMzh0,985 +greenlet/tests/fail_initialstub_already_started.py,sha256=txENn5IyzGx2p-XR1XB7qXmC8JX_4mKDEA8kYBXUQKc,1961 +greenlet/tests/fail_slp_switch.py,sha256=rJBZcZfTWR3e2ERQtPAud6YKShiDsP84PmwOJbp4ey0,524 +greenlet/tests/fail_switch_three_greenlets.py,sha256=zSitV7rkNnaoHYVzAGGLnxz-yPtohXJJzaE8ehFDQ0M,956 +greenlet/tests/fail_switch_three_greenlets2.py,sha256=FPJensn2EJxoropl03JSTVP3kgP33k04h6aDWWozrOk,1285 +greenlet/tests/fail_switch_two_greenlets.py,sha256=1CaI8s3504VbbF1vj1uBYuy-zxBHVzHPIAd1LIc8ONg,817 +greenlet/tests/leakcheck.py,sha256=inbfM7_oVzd8jIKGxCgo4JqpFZaDAnWPkSULJ8vIE1s,11964 +greenlet/tests/test_contextvars.py,sha256=0n5pR_lbpAppc5wFfK0e1SwYLM-fsSFp72B5_ArLPGE,10348 +greenlet/tests/test_cpp.py,sha256=hpxhFAdKJTpAVZP8CBGs1ZcrKdscI9BaDZk4btkI5d4,2736 +greenlet/tests/test_extension_interface.py,sha256=eJ3cwLacdK2WbsrC-4DgeyHdwLRcG4zx7rrkRtqSzC4,3829 +greenlet/tests/test_gc.py,sha256=PCOaRpIyjNnNlDogGL3FZU_lrdXuM-pv1rxeE5TP5mc,2923 +greenlet/tests/test_generator.py,sha256=tONXiTf98VGm347o1b-810daPiwdla5cbpFg6QI1R1g,1240 +greenlet/tests/test_generator_nested.py,sha256=7v4HOYrf1XZP39dk5IUMubdZ8yc3ynwZcqj9GUJyMSA,3718 +greenlet/tests/test_greenlet.py,sha256=zoAy56MtEyz5P93Iknpt2pPjNO3ePYrgM7SDE8Cw_uI,45990 +greenlet/tests/test_greenlet_trash.py,sha256=n2dBlQfOoEO1ODatFi8QdhboH3fB86YtqzcYMYOXxbw,7947 +greenlet/tests/test_leaks.py,sha256=wskLqCAvqZ3qTZkam_wXzd-E5zelUjlXS5Ss8KshtZY,17465 +greenlet/tests/test_stack_saved.py,sha256=eyzqNY2VCGuGlxhT_In6TvZ6Okb0AXFZVyBEnK1jDwA,446 +greenlet/tests/test_throw.py,sha256=u2TQ_WvvCd6N6JdXWIxVEcXkKu5fepDlz9dktYdmtng,3712 +greenlet/tests/test_tracing.py,sha256=VlwzMU0C1noospZhuUMyB7MHw200emIvGCN_6G2p2ZU,8250 +greenlet/tests/test_version.py,sha256=O9DpAITsOFgiRcjd4odQ7ejmwx_N9Q1zQENVcbtFHIc,1339 +greenlet/tests/test_weakref.py,sha256=F8M23btEF87bIbpptLNBORosbQqNZGiYeKMqYjWrsak,883 diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/WHEEL b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/WHEEL new file mode 100644 index 0000000..e4b52df --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (75.1.0) +Root-Is-Purelib: false +Tag: cp312-cp312-win_amd64 + diff --git a/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/top_level.txt b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/top_level.txt new file mode 100644 index 0000000..46725be --- /dev/null +++ b/.venv/Lib/site-packages/greenlet-3.1.1.dist-info/top_level.txt @@ -0,0 +1 @@ +greenlet diff --git a/.venv/Lib/site-packages/greenlet/CObjects.cpp b/.venv/Lib/site-packages/greenlet/CObjects.cpp new file mode 100644 index 0000000..c135995 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/CObjects.cpp @@ -0,0 +1,157 @@ +#ifndef COBJECTS_CPP +#define COBJECTS_CPP +/***************************************************************************** + * C interface + * + * These are exported using the CObject API + */ +#ifdef __clang__ +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wunused-function" +#endif + +#include "greenlet_exceptions.hpp" + +#include "greenlet_internal.hpp" +#include "greenlet_refs.hpp" + + +#include "TThreadStateDestroy.cpp" + +#include "PyGreenlet.hpp" + +using greenlet::PyErrOccurred; +using greenlet::Require; + + + +extern "C" { +static PyGreenlet* +PyGreenlet_GetCurrent(void) +{ + return GET_THREAD_STATE().state().get_current().relinquish_ownership(); +} + +static int +PyGreenlet_SetParent(PyGreenlet* g, PyGreenlet* nparent) +{ + return green_setparent((PyGreenlet*)g, (PyObject*)nparent, NULL); +} + +static PyGreenlet* +PyGreenlet_New(PyObject* run, PyGreenlet* parent) +{ + using greenlet::refs::NewDictReference; + // In the past, we didn't use green_new and green_init, but that + // was a maintenance issue because we duplicated code. This way is + // much safer, but slightly slower. If that's a problem, we could + // refactor green_init to separate argument parsing from initialization. + OwnedGreenlet g = OwnedGreenlet::consuming(green_new(&PyGreenlet_Type, nullptr, nullptr)); + if (!g) { + return NULL; + } + + try { + NewDictReference kwargs; + if (run) { + kwargs.SetItem(mod_globs->str_run, run); + } + if (parent) { + kwargs.SetItem("parent", (PyObject*)parent); + } + + Require(green_init(g.borrow(), mod_globs->empty_tuple, kwargs.borrow())); + } + catch (const PyErrOccurred&) { + return nullptr; + } + + return g.relinquish_ownership(); +} + +static PyObject* +PyGreenlet_Switch(PyGreenlet* self, PyObject* args, PyObject* kwargs) +{ + if (!PyGreenlet_Check(self)) { + PyErr_BadArgument(); + return NULL; + } + + if (args == NULL) { + args = mod_globs->empty_tuple; + } + + if (kwargs == NULL || !PyDict_Check(kwargs)) { + kwargs = NULL; + } + + return green_switch(self, args, kwargs); +} + +static PyObject* +PyGreenlet_Throw(PyGreenlet* self, PyObject* typ, PyObject* val, PyObject* tb) +{ + if (!PyGreenlet_Check(self)) { + PyErr_BadArgument(); + return nullptr; + } + try { + PyErrPieces err_pieces(typ, val, tb); + return internal_green_throw(self, err_pieces).relinquish_ownership(); + } + catch (const PyErrOccurred&) { + return nullptr; + } +} + + + +static int +Extern_PyGreenlet_MAIN(PyGreenlet* self) +{ + if (!PyGreenlet_Check(self)) { + PyErr_BadArgument(); + return -1; + } + return self->pimpl->main(); +} + +static int +Extern_PyGreenlet_ACTIVE(PyGreenlet* self) +{ + if (!PyGreenlet_Check(self)) { + PyErr_BadArgument(); + return -1; + } + return self->pimpl->active(); +} + +static int +Extern_PyGreenlet_STARTED(PyGreenlet* self) +{ + if (!PyGreenlet_Check(self)) { + PyErr_BadArgument(); + return -1; + } + return self->pimpl->started(); +} + +static PyGreenlet* +Extern_PyGreenlet_GET_PARENT(PyGreenlet* self) +{ + if (!PyGreenlet_Check(self)) { + PyErr_BadArgument(); + return NULL; + } + // This can return NULL even if there is no exception + return self->pimpl->parent().acquire(); +} +} // extern C. + +/** End C API ****************************************************************/ +#ifdef __clang__ +# pragma clang diagnostic pop +#endif + + +#endif diff --git a/.venv/Lib/site-packages/greenlet/PyGreenlet.cpp b/.venv/Lib/site-packages/greenlet/PyGreenlet.cpp new file mode 100644 index 0000000..29c0bba --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/PyGreenlet.cpp @@ -0,0 +1,738 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +#ifndef PYGREENLET_CPP +#define PYGREENLET_CPP +/***************** +The Python slot functions for TGreenlet. + */ + + +#define PY_SSIZE_T_CLEAN +#include +#include "structmember.h" // PyMemberDef + +#include "greenlet_internal.hpp" +#include "TThreadStateDestroy.cpp" +#include "TGreenlet.hpp" +// #include "TUserGreenlet.cpp" +// #include "TMainGreenlet.cpp" +// #include "TBrokenGreenlet.cpp" + + +#include "greenlet_refs.hpp" +#include "greenlet_slp_switch.hpp" + +#include "greenlet_thread_support.hpp" +#include "TGreenlet.hpp" + +#include "TGreenletGlobals.cpp" +#include "TThreadStateDestroy.cpp" +#include "PyGreenlet.hpp" +// #include "TGreenlet.cpp" + +// #include "TExceptionState.cpp" +// #include "TPythonState.cpp" +// #include "TStackState.cpp" + +using greenlet::LockGuard; +using greenlet::LockInitError; +using greenlet::PyErrOccurred; +using greenlet::Require; + +using greenlet::g_handle_exit; +using greenlet::single_result; + +using greenlet::Greenlet; +using greenlet::UserGreenlet; +using greenlet::MainGreenlet; +using greenlet::BrokenGreenlet; +using greenlet::ThreadState; +using greenlet::PythonState; + + + +static PyGreenlet* +green_new(PyTypeObject* type, PyObject* UNUSED(args), PyObject* UNUSED(kwds)) +{ + PyGreenlet* o = + (PyGreenlet*)PyBaseObject_Type.tp_new(type, mod_globs->empty_tuple, mod_globs->empty_dict); + if (o) { + new UserGreenlet(o, GET_THREAD_STATE().state().borrow_current()); + assert(Py_REFCNT(o) == 1); + } + return o; +} + + +// green_init is used in the tp_init slot. So it's important that +// it can be called directly from CPython. Thus, we don't use +// BorrowedGreenlet and BorrowedObject --- although in theory +// these should be binary layout compatible, that may not be +// guaranteed to be the case (32-bit linux ppc possibly). +static int +green_init(PyGreenlet* self, PyObject* args, PyObject* kwargs) +{ + PyArgParseParam run; + PyArgParseParam nparent; + static const char* kwlist[] = { + "run", + "parent", + NULL + }; + + // recall: The O specifier does NOT increase the reference count. + if (!PyArg_ParseTupleAndKeywords( + args, kwargs, "|OO:green", (char**)kwlist, &run, &nparent)) { + return -1; + } + + if (run) { + if (green_setrun(self, run, NULL)) { + return -1; + } + } + if (nparent && !nparent.is_None()) { + return green_setparent(self, nparent, NULL); + } + return 0; +} + + + +static int +green_traverse(PyGreenlet* self, visitproc visit, void* arg) +{ + // We must only visit referenced objects, i.e. only objects + // Py_INCREF'ed by this greenlet (directly or indirectly): + // + // - stack_prev is not visited: holds previous stack pointer, but it's not + // referenced + // - frames are not visited as we don't strongly reference them; + // alive greenlets are not garbage collected + // anyway. This can be a problem, however, if this greenlet is + // never allowed to finish, and is referenced from the frame: we + // have an uncollectible cycle in that case. Note that the + // frame object itself is also frequently not even tracked by the GC + // starting with Python 3.7 (frames are allocated by the + // interpreter untracked, and only become tracked when their + // evaluation is finished if they have a refcount > 1). All of + // this is to say that we should probably strongly reference + // the frame object. Doing so, while always allowing GC on a + // greenlet, solves several leaks for us. + + Py_VISIT(self->dict); + if (!self->pimpl) { + // Hmm. I have seen this at interpreter shutdown time, + // I think. That's very odd because this doesn't go away until + // we're ``green_dealloc()``, at which point we shouldn't be + // traversed anymore. + return 0; + } + + return self->pimpl->tp_traverse(visit, arg); +} + +static int +green_is_gc(PyObject* _self) +{ + BorrowedGreenlet self(_self); + int result = 0; + /* Main greenlet can be garbage collected since it can only + become unreachable if the underlying thread exited. + Active greenlets --- including those that are suspended --- + cannot be garbage collected, however. + */ + if (self->main() || !self->active()) { + result = 1; + } + // The main greenlet pointer will eventually go away after the thread dies. + if (self->was_running_in_dead_thread()) { + // Our thread is dead! We can never run again. Might as well + // GC us. Note that if a tuple containing only us and other + // immutable objects had been scanned before this, when we + // would have returned 0, the tuple will take itself out of GC + // tracking and never be investigated again. So that could + // result in both us and the tuple leaking due to an + // unreachable/uncollectible reference. The same goes for + // dictionaries. + // + // It's not a great idea to be changing our GC state on the + // fly. + result = 1; + } + return result; +} + + +static int +green_clear(PyGreenlet* self) +{ + /* Greenlet is only cleared if it is about to be collected. + Since active greenlets are not garbage collectable, we can + be sure that, even if they are deallocated during clear, + nothing they reference is in unreachable or finalizers, + so even if it switches we are relatively safe. */ + // XXX: Are we responsible for clearing weakrefs here? + Py_CLEAR(self->dict); + return self->pimpl->tp_clear(); +} + +/** + * Returns 0 on failure (the object was resurrected) or 1 on success. + **/ +static int +_green_dealloc_kill_started_non_main_greenlet(BorrowedGreenlet self) +{ + /* Hacks hacks hacks copied from instance_dealloc() */ + /* Temporarily resurrect the greenlet. */ + assert(self.REFCNT() == 0); + Py_SET_REFCNT(self.borrow(), 1); + /* Save the current exception, if any. */ + PyErrPieces saved_err; + try { + // BY THE TIME WE GET HERE, the state may actually be going + // away + // if we're shutting down the interpreter and freeing thread + // entries, + // this could result in freeing greenlets that were leaked. So + // we can't try to read the state. + self->deallocing_greenlet_in_thread( + self->thread_state() + ? static_cast(GET_THREAD_STATE()) + : nullptr); + } + catch (const PyErrOccurred&) { + PyErr_WriteUnraisable(self.borrow_o()); + /* XXX what else should we do? */ + } + /* Check for no resurrection must be done while we keep + * our internal reference, otherwise PyFile_WriteObject + * causes recursion if using Py_INCREF/Py_DECREF + */ + if (self.REFCNT() == 1 && self->active()) { + /* Not resurrected, but still not dead! + XXX what else should we do? we complain. */ + PyObject* f = PySys_GetObject("stderr"); + Py_INCREF(self.borrow_o()); /* leak! */ + if (f != NULL) { + PyFile_WriteString("GreenletExit did not kill ", f); + PyFile_WriteObject(self.borrow_o(), f, 0); + PyFile_WriteString("\n", f); + } + } + /* Restore the saved exception. */ + saved_err.PyErrRestore(); + /* Undo the temporary resurrection; can't use DECREF here, + * it would cause a recursive call. + */ + assert(self.REFCNT() > 0); + + Py_ssize_t refcnt = self.REFCNT() - 1; + Py_SET_REFCNT(self.borrow_o(), refcnt); + if (refcnt != 0) { + /* Resurrected! */ + _Py_NewReference(self.borrow_o()); + Py_SET_REFCNT(self.borrow_o(), refcnt); + /* Better to use tp_finalizer slot (PEP 442) + * and call ``PyObject_CallFinalizerFromDealloc``, + * but that's only supported in Python 3.4+; see + * Modules/_io/iobase.c for an example. + * + * The following approach is copied from iobase.c in CPython 2.7. + * (along with much of this function in general). Here's their + * comment: + * + * When called from a heap type's dealloc, the type will be + * decref'ed on return (see e.g. subtype_dealloc in typeobject.c). */ + if (PyType_HasFeature(self.TYPE(), Py_TPFLAGS_HEAPTYPE)) { + Py_INCREF(self.TYPE()); + } + + PyObject_GC_Track((PyObject*)self); + + _Py_DEC_REFTOTAL; +#ifdef COUNT_ALLOCS + --Py_TYPE(self)->tp_frees; + --Py_TYPE(self)->tp_allocs; +#endif /* COUNT_ALLOCS */ + return 0; + } + return 1; +} + + +static void +green_dealloc(PyGreenlet* self) +{ + PyObject_GC_UnTrack(self); + BorrowedGreenlet me(self); + if (me->active() + && me->started() + && !me->main()) { + if (!_green_dealloc_kill_started_non_main_greenlet(me)) { + return; + } + } + + if (self->weakreflist != NULL) { + PyObject_ClearWeakRefs((PyObject*)self); + } + Py_CLEAR(self->dict); + + if (self->pimpl) { + // In case deleting this, which frees some memory, + // somehow winds up calling back into us. That's usually a + //bug in our code. + Greenlet* p = self->pimpl; + self->pimpl = nullptr; + delete p; + } + // and finally we're done. self is now invalid. + Py_TYPE(self)->tp_free((PyObject*)self); +} + + + +static OwnedObject +internal_green_throw(BorrowedGreenlet self, PyErrPieces& err_pieces) +{ + PyObject* result = nullptr; + err_pieces.PyErrRestore(); + assert(PyErr_Occurred()); + if (self->started() && !self->active()) { + /* dead greenlet: turn GreenletExit into a regular return */ + result = g_handle_exit(OwnedObject()).relinquish_ownership(); + } + self->args() <<= result; + + return single_result(self->g_switch()); +} + + + +PyDoc_STRVAR( + green_switch_doc, + "switch(*args, **kwargs)\n" + "\n" + "Switch execution to this greenlet.\n" + "\n" + "If this greenlet has never been run, then this greenlet\n" + "will be switched to using the body of ``self.run(*args, **kwargs)``.\n" + "\n" + "If the greenlet is active (has been run, but was switch()'ed\n" + "out before leaving its run function), then this greenlet will\n" + "be resumed and the return value to its switch call will be\n" + "None if no arguments are given, the given argument if one\n" + "argument is given, or the args tuple and keyword args dict if\n" + "multiple arguments are given.\n" + "\n" + "If the greenlet is dead, or is the current greenlet then this\n" + "function will simply return the arguments using the same rules as\n" + "above.\n"); + +static PyObject* +green_switch(PyGreenlet* self, PyObject* args, PyObject* kwargs) +{ + using greenlet::SwitchingArgs; + SwitchingArgs switch_args(OwnedObject::owning(args), OwnedObject::owning(kwargs)); + self->pimpl->may_switch_away(); + self->pimpl->args() <<= switch_args; + + // If we're switching out of a greenlet, and that switch is the + // last thing the greenlet does, the greenlet ought to be able to + // go ahead and die at that point. Currently, someone else must + // manually switch back to the greenlet so that we "fall off the + // end" and can perform cleanup. You'd think we'd be able to + // figure out that this is happening using the frame's ``f_lasti`` + // member, which is supposed to be an index into + // ``frame->f_code->co_code``, the bytecode string. However, in + // recent interpreters, ``f_lasti`` tends not to be updated thanks + // to things like the PREDICT() macros in ceval.c. So it doesn't + // really work to do that in many cases. For example, the Python + // code: + // def run(): + // greenlet.getcurrent().parent.switch() + // produces bytecode of len 16, with the actual call to switch() + // being at index 10 (in Python 3.10). However, the reported + // ``f_lasti`` we actually see is...5! (Which happens to be the + // second byte of the CALL_METHOD op for ``getcurrent()``). + + try { + //OwnedObject result = single_result(self->pimpl->g_switch()); + OwnedObject result(single_result(self->pimpl->g_switch())); +#ifndef NDEBUG + // Note that the current greenlet isn't necessarily self. If self + // finished, we went to one of its parents. + assert(!self->pimpl->args()); + + const BorrowedGreenlet& current = GET_THREAD_STATE().state().borrow_current(); + // It's possible it's never been switched to. + assert(!current->args()); +#endif + PyObject* p = result.relinquish_ownership(); + + if (!p && !PyErr_Occurred()) { + // This shouldn't be happening anymore, so the asserts + // are there for debug builds. Non-debug builds + // crash "gracefully" in this case, although there is an + // argument to be made for killing the process in all + // cases --- for this to be the case, our switches + // probably nested in an incorrect way, so the state is + // suspicious. Nothing should be corrupt though, just + // confused at the Python level. Letting this propagate is + // probably good enough. + assert(p || PyErr_Occurred()); + throw PyErrOccurred( + mod_globs->PyExc_GreenletError, + "Greenlet.switch() returned NULL without an exception set." + ); + } + return p; + } + catch(const PyErrOccurred&) { + return nullptr; + } +} + +PyDoc_STRVAR( + green_throw_doc, + "Switches execution to this greenlet, but immediately raises the\n" + "given exception in this greenlet. If no argument is provided, the " + "exception\n" + "defaults to `greenlet.GreenletExit`. The normal exception\n" + "propagation rules apply, as described for `switch`. Note that calling " + "this\n" + "method is almost equivalent to the following::\n" + "\n" + " def raiser():\n" + " raise typ, val, tb\n" + " g_raiser = greenlet(raiser, parent=g)\n" + " g_raiser.switch()\n" + "\n" + "except that this trick does not work for the\n" + "`greenlet.GreenletExit` exception, which would not propagate\n" + "from ``g_raiser`` to ``g``.\n"); + +static PyObject* +green_throw(PyGreenlet* self, PyObject* args) +{ + PyArgParseParam typ(mod_globs->PyExc_GreenletExit); + PyArgParseParam val; + PyArgParseParam tb; + + if (!PyArg_ParseTuple(args, "|OOO:throw", &typ, &val, &tb)) { + return nullptr; + } + + assert(typ.borrow() || val.borrow()); + + self->pimpl->may_switch_away(); + try { + // Both normalizing the error and the actual throw_greenlet + // could throw PyErrOccurred. + PyErrPieces err_pieces(typ.borrow(), val.borrow(), tb.borrow()); + + return internal_green_throw(self, err_pieces).relinquish_ownership(); + } + catch (const PyErrOccurred&) { + return nullptr; + } +} + +static int +green_bool(PyGreenlet* self) +{ + return self->pimpl->active(); +} + +/** + * CAUTION: Allocates memory, may run GC and arbitrary Python code. + */ +static PyObject* +green_getdict(PyGreenlet* self, void* UNUSED(context)) +{ + if (self->dict == NULL) { + self->dict = PyDict_New(); + if (self->dict == NULL) { + return NULL; + } + } + Py_INCREF(self->dict); + return self->dict; +} + +static int +green_setdict(PyGreenlet* self, PyObject* val, void* UNUSED(context)) +{ + PyObject* tmp; + + if (val == NULL) { + PyErr_SetString(PyExc_TypeError, "__dict__ may not be deleted"); + return -1; + } + if (!PyDict_Check(val)) { + PyErr_SetString(PyExc_TypeError, "__dict__ must be a dictionary"); + return -1; + } + tmp = self->dict; + Py_INCREF(val); + self->dict = val; + Py_XDECREF(tmp); + return 0; +} + +static bool +_green_not_dead(BorrowedGreenlet self) +{ + // XXX: Where else should we do this? + // Probably on entry to most Python-facing functions? + if (self->was_running_in_dead_thread()) { + self->deactivate_and_free(); + return false; + } + return self->active() || !self->started(); +} + + +static PyObject* +green_getdead(PyGreenlet* self, void* UNUSED(context)) +{ + if (_green_not_dead(self)) { + Py_RETURN_FALSE; + } + else { + Py_RETURN_TRUE; + } +} + +static PyObject* +green_get_stack_saved(PyGreenlet* self, void* UNUSED(context)) +{ + return PyLong_FromSsize_t(self->pimpl->stack_saved()); +} + + +static PyObject* +green_getrun(PyGreenlet* self, void* UNUSED(context)) +{ + try { + OwnedObject result(BorrowedGreenlet(self)->run()); + return result.relinquish_ownership(); + } + catch(const PyErrOccurred&) { + return nullptr; + } +} + + +static int +green_setrun(PyGreenlet* self, PyObject* nrun, void* UNUSED(context)) +{ + try { + BorrowedGreenlet(self)->run(nrun); + return 0; + } + catch(const PyErrOccurred&) { + return -1; + } +} + +static PyObject* +green_getparent(PyGreenlet* self, void* UNUSED(context)) +{ + return BorrowedGreenlet(self)->parent().acquire_or_None(); +} + + +static int +green_setparent(PyGreenlet* self, PyObject* nparent, void* UNUSED(context)) +{ + try { + BorrowedGreenlet(self)->parent(nparent); + } + catch(const PyErrOccurred&) { + return -1; + } + return 0; +} + + +static PyObject* +green_getcontext(const PyGreenlet* self, void* UNUSED(context)) +{ + const Greenlet *const g = self->pimpl; + try { + OwnedObject result(g->context()); + return result.relinquish_ownership(); + } + catch(const PyErrOccurred&) { + return nullptr; + } +} + +static int +green_setcontext(PyGreenlet* self, PyObject* nctx, void* UNUSED(context)) +{ + try { + BorrowedGreenlet(self)->context(nctx); + return 0; + } + catch(const PyErrOccurred&) { + return -1; + } +} + + +static PyObject* +green_getframe(PyGreenlet* self, void* UNUSED(context)) +{ + const PythonState::OwnedFrame& top_frame = BorrowedGreenlet(self)->top_frame(); + return top_frame.acquire_or_None(); +} + + +static PyObject* +green_getstate(PyGreenlet* self) +{ + PyErr_Format(PyExc_TypeError, + "cannot serialize '%s' object", + Py_TYPE(self)->tp_name); + return nullptr; +} + +static PyObject* +green_repr(PyGreenlet* _self) +{ + BorrowedGreenlet self(_self); + /* + Return a string like + + + The handling of greenlets across threads is not super good. + We mostly use the internal definitions of these terms, but they + generally should make sense to users as well. + */ + PyObject* result; + int never_started = !self->started() && !self->active(); + + const char* const tp_name = Py_TYPE(self)->tp_name; + + if (_green_not_dead(self)) { + /* XXX: The otid= is almost useless because you can't correlate it to + any thread identifier exposed to Python. We could use + PyThreadState_GET()->thread_id, but we'd need to save that in the + greenlet, or save the whole PyThreadState object itself. + + As it stands, its only useful for identifying greenlets from the same thread. + */ + const char* state_in_thread; + if (self->was_running_in_dead_thread()) { + // The thread it was running in is dead! + // This can happen, especially at interpreter shut down. + // It complicates debugging output because it may be + // impossible to access the current thread state at that + // time. Thus, don't access the current thread state. + state_in_thread = " (thread exited)"; + } + else { + state_in_thread = GET_THREAD_STATE().state().is_current(self) + ? " current" + : (self->started() ? " suspended" : ""); + } + result = PyUnicode_FromFormat( + "<%s object at %p (otid=%p)%s%s%s%s>", + tp_name, + self.borrow_o(), + self->thread_state(), + state_in_thread, + self->active() ? " active" : "", + never_started ? " pending" : " started", + self->main() ? " main" : "" + ); + } + else { + result = PyUnicode_FromFormat( + "<%s object at %p (otid=%p) %sdead>", + tp_name, + self.borrow_o(), + self->thread_state(), + self->was_running_in_dead_thread() + ? "(thread exited) " + : "" + ); + } + + return result; +} + + +static PyMethodDef green_methods[] = { + { + .ml_name="switch", + .ml_meth=reinterpret_cast(green_switch), + .ml_flags=METH_VARARGS | METH_KEYWORDS, + .ml_doc=green_switch_doc + }, + {.ml_name="throw", .ml_meth=(PyCFunction)green_throw, .ml_flags=METH_VARARGS, .ml_doc=green_throw_doc}, + {.ml_name="__getstate__", .ml_meth=(PyCFunction)green_getstate, .ml_flags=METH_NOARGS, .ml_doc=NULL}, + {.ml_name=NULL, .ml_meth=NULL} /* sentinel */ +}; + +static PyGetSetDef green_getsets[] = { + /* name, getter, setter, doc, context pointer */ + {.name="__dict__", .get=(getter)green_getdict, .set=(setter)green_setdict}, + {.name="run", .get=(getter)green_getrun, .set=(setter)green_setrun}, + {.name="parent", .get=(getter)green_getparent, .set=(setter)green_setparent}, + {.name="gr_frame", .get=(getter)green_getframe }, + { + .name="gr_context", + .get=(getter)green_getcontext, + .set=(setter)green_setcontext + }, + {.name="dead", .get=(getter)green_getdead}, + {.name="_stack_saved", .get=(getter)green_get_stack_saved}, + {.name=NULL} +}; + +static PyMemberDef green_members[] = { + {.name=NULL} +}; + +static PyNumberMethods green_as_number = { + .nb_bool=(inquiry)green_bool, +}; + + +PyTypeObject PyGreenlet_Type = { + .ob_base=PyVarObject_HEAD_INIT(NULL, 0) + .tp_name="greenlet.greenlet", /* tp_name */ + .tp_basicsize=sizeof(PyGreenlet), /* tp_basicsize */ + /* methods */ + .tp_dealloc=(destructor)green_dealloc, /* tp_dealloc */ + .tp_repr=(reprfunc)green_repr, /* tp_repr */ + .tp_as_number=&green_as_number, /* tp_as _number*/ + .tp_flags=G_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ + .tp_doc="greenlet(run=None, parent=None) -> greenlet\n\n" + "Creates a new greenlet object (without running it).\n\n" + " - *run* -- The callable to invoke.\n" + " - *parent* -- The parent greenlet. The default is the current " + "greenlet.", /* tp_doc */ + .tp_traverse=(traverseproc)green_traverse, /* tp_traverse */ + .tp_clear=(inquiry)green_clear, /* tp_clear */ + .tp_weaklistoffset=offsetof(PyGreenlet, weakreflist), /* tp_weaklistoffset */ + + .tp_methods=green_methods, /* tp_methods */ + .tp_members=green_members, /* tp_members */ + .tp_getset=green_getsets, /* tp_getset */ + .tp_dictoffset=offsetof(PyGreenlet, dict), /* tp_dictoffset */ + .tp_init=(initproc)green_init, /* tp_init */ + .tp_alloc=PyType_GenericAlloc, /* tp_alloc */ + .tp_new=(newfunc)green_new, /* tp_new */ + .tp_free=PyObject_GC_Del, /* tp_free */ + .tp_is_gc=(inquiry)green_is_gc, /* tp_is_gc */ +}; + +#endif + +// Local Variables: +// flycheck-clang-include-path: ("/opt/local/Library/Frameworks/Python.framework/Versions/3.8/include/python3.8") +// End: diff --git a/.venv/Lib/site-packages/greenlet/PyGreenlet.hpp b/.venv/Lib/site-packages/greenlet/PyGreenlet.hpp new file mode 100644 index 0000000..df6cd80 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/PyGreenlet.hpp @@ -0,0 +1,35 @@ +#ifndef PYGREENLET_HPP +#define PYGREENLET_HPP + + +#include "greenlet.h" +#include "greenlet_compiler_compat.hpp" +#include "greenlet_refs.hpp" + + +using greenlet::refs::OwnedGreenlet; +using greenlet::refs::BorrowedGreenlet; +using greenlet::refs::BorrowedObject;; +using greenlet::refs::OwnedObject; +using greenlet::refs::PyErrPieces; + + +// XXX: These doesn't really belong here, it's not a Python slot. +static OwnedObject internal_green_throw(BorrowedGreenlet self, PyErrPieces& err_pieces); + +static PyGreenlet* green_new(PyTypeObject* type, PyObject* UNUSED(args), PyObject* UNUSED(kwds)); +static int green_clear(PyGreenlet* self); +static int green_init(PyGreenlet* self, PyObject* args, PyObject* kwargs); +static int green_setparent(PyGreenlet* self, PyObject* nparent, void* UNUSED(context)); +static int green_setrun(PyGreenlet* self, PyObject* nrun, void* UNUSED(context)); +static int green_traverse(PyGreenlet* self, visitproc visit, void* arg); +static void green_dealloc(PyGreenlet* self); +static PyObject* green_getparent(PyGreenlet* self, void* UNUSED(context)); + +static int green_is_gc(PyObject* self); +static PyObject* green_getdead(PyGreenlet* self, void* UNUSED(context)); +static PyObject* green_getrun(PyGreenlet* self, void* UNUSED(context)); +static int green_setcontext(PyGreenlet* self, PyObject* nctx, void* UNUSED(context)); +static PyObject* green_getframe(PyGreenlet* self, void* UNUSED(context)); +static PyObject* green_repr(PyGreenlet* self); +#endif diff --git a/.venv/Lib/site-packages/greenlet/PyGreenletUnswitchable.cpp b/.venv/Lib/site-packages/greenlet/PyGreenletUnswitchable.cpp new file mode 100644 index 0000000..1b768ee --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/PyGreenletUnswitchable.cpp @@ -0,0 +1,147 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + Implementation of the Python slots for PyGreenletUnswitchable_Type +*/ +#ifndef PY_GREENLET_UNSWITCHABLE_CPP +#define PY_GREENLET_UNSWITCHABLE_CPP + + + +#define PY_SSIZE_T_CLEAN +#include +#include "structmember.h" // PyMemberDef + +#include "greenlet_internal.hpp" +// Code after this point can assume access to things declared in stdint.h, +// including the fixed-width types. This goes for the platform-specific switch functions +// as well. +#include "greenlet_refs.hpp" +#include "greenlet_slp_switch.hpp" + +#include "greenlet_thread_support.hpp" +#include "TGreenlet.hpp" + +#include "TGreenlet.cpp" +#include "TGreenletGlobals.cpp" +#include "TThreadStateDestroy.cpp" + + +using greenlet::LockGuard; +using greenlet::LockInitError; +using greenlet::PyErrOccurred; +using greenlet::Require; + +using greenlet::g_handle_exit; +using greenlet::single_result; + +using greenlet::Greenlet; +using greenlet::UserGreenlet; +using greenlet::MainGreenlet; +using greenlet::BrokenGreenlet; +using greenlet::ThreadState; +using greenlet::PythonState; + + +#include "PyGreenlet.hpp" + +static PyGreenlet* +green_unswitchable_new(PyTypeObject* type, PyObject* UNUSED(args), PyObject* UNUSED(kwds)) +{ + PyGreenlet* o = + (PyGreenlet*)PyBaseObject_Type.tp_new(type, mod_globs->empty_tuple, mod_globs->empty_dict); + if (o) { + new BrokenGreenlet(o, GET_THREAD_STATE().state().borrow_current()); + assert(Py_REFCNT(o) == 1); + } + return o; +} + +static PyObject* +green_unswitchable_getforce(PyGreenlet* self, void* UNUSED(context)) +{ + BrokenGreenlet* broken = dynamic_cast(self->pimpl); + return PyBool_FromLong(broken->_force_switch_error); +} + +static int +green_unswitchable_setforce(PyGreenlet* self, PyObject* nforce, void* UNUSED(context)) +{ + if (!nforce) { + PyErr_SetString( + PyExc_AttributeError, + "Cannot delete force_switch_error" + ); + return -1; + } + BrokenGreenlet* broken = dynamic_cast(self->pimpl); + int is_true = PyObject_IsTrue(nforce); + if (is_true == -1) { + return -1; + } + broken->_force_switch_error = is_true; + return 0; +} + +static PyObject* +green_unswitchable_getforceslp(PyGreenlet* self, void* UNUSED(context)) +{ + BrokenGreenlet* broken = dynamic_cast(self->pimpl); + return PyBool_FromLong(broken->_force_slp_switch_error); +} + +static int +green_unswitchable_setforceslp(PyGreenlet* self, PyObject* nforce, void* UNUSED(context)) +{ + if (!nforce) { + PyErr_SetString( + PyExc_AttributeError, + "Cannot delete force_slp_switch_error" + ); + return -1; + } + BrokenGreenlet* broken = dynamic_cast(self->pimpl); + int is_true = PyObject_IsTrue(nforce); + if (is_true == -1) { + return -1; + } + broken->_force_slp_switch_error = is_true; + return 0; +} + +static PyGetSetDef green_unswitchable_getsets[] = { + /* name, getter, setter, doc, closure (context pointer) */ + { + .name="force_switch_error", + .get=(getter)green_unswitchable_getforce, + .set=(setter)green_unswitchable_setforce, + .doc=NULL + }, + { + .name="force_slp_switch_error", + .get=(getter)green_unswitchable_getforceslp, + .set=(setter)green_unswitchable_setforceslp, + .doc=nullptr + }, + {.name=nullptr} +}; + +PyTypeObject PyGreenletUnswitchable_Type = { + .ob_base=PyVarObject_HEAD_INIT(NULL, 0) + .tp_name="greenlet._greenlet.UnswitchableGreenlet", + .tp_dealloc= (destructor)green_dealloc, /* tp_dealloc */ + .tp_flags=G_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ + .tp_doc="Undocumented internal class", /* tp_doc */ + .tp_traverse=(traverseproc)green_traverse, /* tp_traverse */ + .tp_clear=(inquiry)green_clear, /* tp_clear */ + + .tp_getset=green_unswitchable_getsets, /* tp_getset */ + .tp_base=&PyGreenlet_Type, /* tp_base */ + .tp_init=(initproc)green_init, /* tp_init */ + .tp_alloc=PyType_GenericAlloc, /* tp_alloc */ + .tp_new=(newfunc)green_unswitchable_new, /* tp_new */ + .tp_free=PyObject_GC_Del, /* tp_free */ + .tp_is_gc=(inquiry)green_is_gc, /* tp_is_gc */ +}; + + +#endif diff --git a/.venv/Lib/site-packages/greenlet/PyModule.cpp b/.venv/Lib/site-packages/greenlet/PyModule.cpp new file mode 100644 index 0000000..6adcb5c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/PyModule.cpp @@ -0,0 +1,292 @@ +#ifndef PY_MODULE_CPP +#define PY_MODULE_CPP + +#include "greenlet_internal.hpp" + + +#include "TGreenletGlobals.cpp" +#include "TMainGreenlet.cpp" +#include "TThreadStateDestroy.cpp" + +using greenlet::LockGuard; +using greenlet::ThreadState; + +#ifdef __clang__ +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wunused-function" +# pragma clang diagnostic ignored "-Wunused-variable" +#endif + +PyDoc_STRVAR(mod_getcurrent_doc, + "getcurrent() -> greenlet\n" + "\n" + "Returns the current greenlet (i.e. the one which called this " + "function).\n"); + +static PyObject* +mod_getcurrent(PyObject* UNUSED(module)) +{ + return GET_THREAD_STATE().state().get_current().relinquish_ownership_o(); +} + +PyDoc_STRVAR(mod_settrace_doc, + "settrace(callback) -> object\n" + "\n" + "Sets a new tracing function and returns the previous one.\n"); +static PyObject* +mod_settrace(PyObject* UNUSED(module), PyObject* args) +{ + PyArgParseParam tracefunc; + if (!PyArg_ParseTuple(args, "O", &tracefunc)) { + return NULL; + } + ThreadState& state = GET_THREAD_STATE(); + OwnedObject previous = state.get_tracefunc(); + if (!previous) { + previous = Py_None; + } + + state.set_tracefunc(tracefunc); + + return previous.relinquish_ownership(); +} + +PyDoc_STRVAR(mod_gettrace_doc, + "gettrace() -> object\n" + "\n" + "Returns the currently set tracing function, or None.\n"); + +static PyObject* +mod_gettrace(PyObject* UNUSED(module)) +{ + OwnedObject tracefunc = GET_THREAD_STATE().state().get_tracefunc(); + if (!tracefunc) { + tracefunc = Py_None; + } + return tracefunc.relinquish_ownership(); +} + + + +PyDoc_STRVAR(mod_set_thread_local_doc, + "set_thread_local(key, value) -> None\n" + "\n" + "Set a value in the current thread-local dictionary. Debugging only.\n"); + +static PyObject* +mod_set_thread_local(PyObject* UNUSED(module), PyObject* args) +{ + PyArgParseParam key; + PyArgParseParam value; + PyObject* result = NULL; + + if (PyArg_UnpackTuple(args, "set_thread_local", 2, 2, &key, &value)) { + if(PyDict_SetItem( + PyThreadState_GetDict(), // borrow + key, + value) == 0 ) { + // success + Py_INCREF(Py_None); + result = Py_None; + } + } + return result; +} + +PyDoc_STRVAR(mod_get_pending_cleanup_count_doc, + "get_pending_cleanup_count() -> Integer\n" + "\n" + "Get the number of greenlet cleanup operations pending. Testing only.\n"); + + +static PyObject* +mod_get_pending_cleanup_count(PyObject* UNUSED(module)) +{ + LockGuard cleanup_lock(*mod_globs->thread_states_to_destroy_lock); + return PyLong_FromSize_t(mod_globs->thread_states_to_destroy.size()); +} + +PyDoc_STRVAR(mod_get_total_main_greenlets_doc, + "get_total_main_greenlets() -> Integer\n" + "\n" + "Quickly return the number of main greenlets that exist. Testing only.\n"); + +static PyObject* +mod_get_total_main_greenlets(PyObject* UNUSED(module)) +{ + return PyLong_FromSize_t(G_TOTAL_MAIN_GREENLETS); +} + + + +PyDoc_STRVAR(mod_get_clocks_used_doing_optional_cleanup_doc, + "get_clocks_used_doing_optional_cleanup() -> Integer\n" + "\n" + "Get the number of clock ticks the program has used doing optional " + "greenlet cleanup.\n" + "Beginning in greenlet 2.0, greenlet tries to find and dispose of greenlets\n" + "that leaked after a thread exited. This requires invoking Python's garbage collector,\n" + "which may have a performance cost proportional to the number of live objects.\n" + "This function returns the amount of processor time\n" + "greenlet has used to do this. In programs that run with very large amounts of live\n" + "objects, this metric can be used to decide whether the cost of doing this cleanup\n" + "is worth the memory leak being corrected. If not, you can disable the cleanup\n" + "using ``enable_optional_cleanup(False)``.\n" + "The units are arbitrary and can only be compared to themselves (similarly to ``time.clock()``);\n" + "for example, to see how it scales with your heap. You can attempt to convert them into seconds\n" + "by dividing by the value of CLOCKS_PER_SEC." + "If cleanup has been disabled, returns None." + "\n" + "This is an implementation specific, provisional API. It may be changed or removed\n" + "in the future.\n" + ".. versionadded:: 2.0" + ); +static PyObject* +mod_get_clocks_used_doing_optional_cleanup(PyObject* UNUSED(module)) +{ + std::clock_t& clocks = ThreadState::clocks_used_doing_gc(); + + if (clocks == std::clock_t(-1)) { + Py_RETURN_NONE; + } + // This might not actually work on some implementations; clock_t + // is an opaque type. + return PyLong_FromSsize_t(clocks); +} + +PyDoc_STRVAR(mod_enable_optional_cleanup_doc, + "mod_enable_optional_cleanup(bool) -> None\n" + "\n" + "Enable or disable optional cleanup operations.\n" + "See ``get_clocks_used_doing_optional_cleanup()`` for details.\n" + ); +static PyObject* +mod_enable_optional_cleanup(PyObject* UNUSED(module), PyObject* flag) +{ + int is_true = PyObject_IsTrue(flag); + if (is_true == -1) { + return nullptr; + } + + std::clock_t& clocks = ThreadState::clocks_used_doing_gc(); + if (is_true) { + // If we already have a value, we don't want to lose it. + if (clocks == std::clock_t(-1)) { + clocks = 0; + } + } + else { + clocks = std::clock_t(-1); + } + Py_RETURN_NONE; +} + + + + +#if !GREENLET_PY313 +PyDoc_STRVAR(mod_get_tstate_trash_delete_nesting_doc, + "get_tstate_trash_delete_nesting() -> Integer\n" + "\n" + "Return the 'trash can' nesting level. Testing only.\n"); +static PyObject* +mod_get_tstate_trash_delete_nesting(PyObject* UNUSED(module)) +{ + PyThreadState* tstate = PyThreadState_GET(); + +#if GREENLET_PY312 + return PyLong_FromLong(tstate->trash.delete_nesting); +#else + return PyLong_FromLong(tstate->trash_delete_nesting); +#endif +} +#endif + + + + +static PyMethodDef GreenMethods[] = { + { + .ml_name="getcurrent", + .ml_meth=(PyCFunction)mod_getcurrent, + .ml_flags=METH_NOARGS, + .ml_doc=mod_getcurrent_doc + }, + { + .ml_name="settrace", + .ml_meth=(PyCFunction)mod_settrace, + .ml_flags=METH_VARARGS, + .ml_doc=mod_settrace_doc + }, + { + .ml_name="gettrace", + .ml_meth=(PyCFunction)mod_gettrace, + .ml_flags=METH_NOARGS, + .ml_doc=mod_gettrace_doc + }, + { + .ml_name="set_thread_local", + .ml_meth=(PyCFunction)mod_set_thread_local, + .ml_flags=METH_VARARGS, + .ml_doc=mod_set_thread_local_doc + }, + { + .ml_name="get_pending_cleanup_count", + .ml_meth=(PyCFunction)mod_get_pending_cleanup_count, + .ml_flags=METH_NOARGS, + .ml_doc=mod_get_pending_cleanup_count_doc + }, + { + .ml_name="get_total_main_greenlets", + .ml_meth=(PyCFunction)mod_get_total_main_greenlets, + .ml_flags=METH_NOARGS, + .ml_doc=mod_get_total_main_greenlets_doc + }, + { + .ml_name="get_clocks_used_doing_optional_cleanup", + .ml_meth=(PyCFunction)mod_get_clocks_used_doing_optional_cleanup, + .ml_flags=METH_NOARGS, + .ml_doc=mod_get_clocks_used_doing_optional_cleanup_doc + }, + { + .ml_name="enable_optional_cleanup", + .ml_meth=(PyCFunction)mod_enable_optional_cleanup, + .ml_flags=METH_O, + .ml_doc=mod_enable_optional_cleanup_doc + }, +#if !GREENLET_PY313 + { + .ml_name="get_tstate_trash_delete_nesting", + .ml_meth=(PyCFunction)mod_get_tstate_trash_delete_nesting, + .ml_flags=METH_NOARGS, + .ml_doc=mod_get_tstate_trash_delete_nesting_doc + }, +#endif + {.ml_name=NULL, .ml_meth=NULL} /* Sentinel */ +}; + +static const char* const copy_on_greentype[] = { + "getcurrent", + "error", + "GreenletExit", + "settrace", + "gettrace", + NULL +}; + +static struct PyModuleDef greenlet_module_def = { + .m_base=PyModuleDef_HEAD_INIT, + .m_name="greenlet._greenlet", + .m_doc=NULL, + .m_size=-1, + .m_methods=GreenMethods, +}; + + +#endif + +#ifdef __clang__ +# pragma clang diagnostic pop +#elif defined(__GNUC__) +# pragma GCC diagnostic pop +#endif diff --git a/.venv/Lib/site-packages/greenlet/TBrokenGreenlet.cpp b/.venv/Lib/site-packages/greenlet/TBrokenGreenlet.cpp new file mode 100644 index 0000000..7e9ab5b --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TBrokenGreenlet.cpp @@ -0,0 +1,45 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + * Implementation of greenlet::UserGreenlet. + * + * Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ + +#include "TGreenlet.hpp" + +namespace greenlet { + +void* BrokenGreenlet::operator new(size_t UNUSED(count)) +{ + return allocator.allocate(1); +} + + +void BrokenGreenlet::operator delete(void* ptr) +{ + return allocator.deallocate(static_cast(ptr), + 1); +} + +greenlet::PythonAllocator greenlet::BrokenGreenlet::allocator; + +bool +BrokenGreenlet::force_slp_switch_error() const noexcept +{ + return this->_force_slp_switch_error; +} + +UserGreenlet::switchstack_result_t BrokenGreenlet::g_switchstack(void) +{ + if (this->_force_switch_error) { + return switchstack_result_t(-1); + } + return UserGreenlet::g_switchstack(); +} + +}; //namespace greenlet diff --git a/.venv/Lib/site-packages/greenlet/TExceptionState.cpp b/.venv/Lib/site-packages/greenlet/TExceptionState.cpp new file mode 100644 index 0000000..08a94ae --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TExceptionState.cpp @@ -0,0 +1,62 @@ +#ifndef GREENLET_EXCEPTION_STATE_CPP +#define GREENLET_EXCEPTION_STATE_CPP + +#include +#include "TGreenlet.hpp" + +namespace greenlet { + + +ExceptionState::ExceptionState() +{ + this->clear(); +} + +void ExceptionState::operator<<(const PyThreadState *const tstate) noexcept +{ + this->exc_info = tstate->exc_info; + this->exc_state = tstate->exc_state; +} + +void ExceptionState::operator>>(PyThreadState *const tstate) noexcept +{ + tstate->exc_state = this->exc_state; + tstate->exc_info = + this->exc_info ? this->exc_info : &tstate->exc_state; + this->clear(); +} + +void ExceptionState::clear() noexcept +{ + this->exc_info = nullptr; + this->exc_state.exc_value = nullptr; +#if !GREENLET_PY311 + this->exc_state.exc_type = nullptr; + this->exc_state.exc_traceback = nullptr; +#endif + this->exc_state.previous_item = nullptr; +} + +int ExceptionState::tp_traverse(visitproc visit, void* arg) noexcept +{ + Py_VISIT(this->exc_state.exc_value); +#if !GREENLET_PY311 + Py_VISIT(this->exc_state.exc_type); + Py_VISIT(this->exc_state.exc_traceback); +#endif + return 0; +} + +void ExceptionState::tp_clear() noexcept +{ + Py_CLEAR(this->exc_state.exc_value); +#if !GREENLET_PY311 + Py_CLEAR(this->exc_state.exc_type); + Py_CLEAR(this->exc_state.exc_traceback); +#endif +} + + +}; // namespace greenlet + +#endif // GREENLET_EXCEPTION_STATE_CPP diff --git a/.venv/Lib/site-packages/greenlet/TGreenlet.cpp b/.venv/Lib/site-packages/greenlet/TGreenlet.cpp new file mode 100644 index 0000000..4698a17 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TGreenlet.cpp @@ -0,0 +1,718 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + * Implementation of greenlet::Greenlet. + * + * Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ +#ifndef TGREENLET_CPP +#define TGREENLET_CPP +#include "greenlet_internal.hpp" +#include "TGreenlet.hpp" + + +#include "TGreenletGlobals.cpp" +#include "TThreadStateDestroy.cpp" + +namespace greenlet { + +Greenlet::Greenlet(PyGreenlet* p) + : Greenlet(p, StackState()) +{ +} + +Greenlet::Greenlet(PyGreenlet* p, const StackState& initial_stack) + : _self(p), stack_state(initial_stack) +{ + assert(p->pimpl == nullptr); + p->pimpl = this; +} + +Greenlet::~Greenlet() +{ + // XXX: Can't do this. tp_clear is a virtual function, and by the + // time we're here, we've sliced off our child classes. + //this->tp_clear(); + this->_self->pimpl = nullptr; +} + +bool +Greenlet::force_slp_switch_error() const noexcept +{ + return false; +} + +void +Greenlet::release_args() +{ + this->switch_args.CLEAR(); +} + +/** + * CAUTION: This will allocate memory and may trigger garbage + * collection and arbitrary Python code. + */ +OwnedObject +Greenlet::throw_GreenletExit_during_dealloc(const ThreadState& UNUSED(current_thread_state)) +{ + // If we're killed because we lost all references in the + // middle of a switch, that's ok. Don't reset the args/kwargs, + // we still want to pass them to the parent. + PyErr_SetString(mod_globs->PyExc_GreenletExit, + "Killing the greenlet because all references have vanished."); + // To get here it had to have run before + return this->g_switch(); +} + +inline void +Greenlet::slp_restore_state() noexcept +{ +#ifdef SLP_BEFORE_RESTORE_STATE + SLP_BEFORE_RESTORE_STATE(); +#endif + this->stack_state.copy_heap_to_stack( + this->thread_state()->borrow_current()->stack_state); +} + + +inline int +Greenlet::slp_save_state(char *const stackref) noexcept +{ + // XXX: This used to happen in the middle, before saving, but + // after finding the next owner. Does that matter? This is + // only defined for Sparc/GCC where it flushes register + // windows to the stack (I think) +#ifdef SLP_BEFORE_SAVE_STATE + SLP_BEFORE_SAVE_STATE(); +#endif + return this->stack_state.copy_stack_to_heap(stackref, + this->thread_state()->borrow_current()->stack_state); +} + +/** + * CAUTION: This will allocate memory and may trigger garbage + * collection and arbitrary Python code. + */ +OwnedObject +Greenlet::on_switchstack_or_initialstub_failure( + Greenlet* target, + const Greenlet::switchstack_result_t& err, + const bool target_was_me, + const bool was_initial_stub) +{ + // If we get here, either g_initialstub() + // failed, or g_switchstack() failed. Either one of those + // cases SHOULD leave us in the original greenlet with a valid stack. + if (!PyErr_Occurred()) { + PyErr_SetString( + PyExc_SystemError, + was_initial_stub + ? "Failed to switch stacks into a greenlet for the first time." + : "Failed to switch stacks into a running greenlet."); + } + this->release_args(); + + if (target && !target_was_me) { + target->murder_in_place(); + } + + assert(!err.the_new_current_greenlet); + assert(!err.origin_greenlet); + return OwnedObject(); + +} + +OwnedGreenlet +Greenlet::g_switchstack_success() noexcept +{ + PyThreadState* tstate = PyThreadState_GET(); + // restore the saved state + this->python_state >> tstate; + this->exception_state >> tstate; + + // The thread state hasn't been changed yet. + ThreadState* thread_state = this->thread_state(); + OwnedGreenlet result(thread_state->get_current()); + thread_state->set_current(this->self()); + //assert(thread_state->borrow_current().borrow() == this->_self); + return result; +} + +Greenlet::switchstack_result_t +Greenlet::g_switchstack(void) +{ + // if any of these assertions fail, it's likely because we + // switched away and tried to switch back to us. Early stages of + // switching are not reentrant because we re-use ``this->args()``. + // Switching away would happen if we trigger a garbage collection + // (by just using some Python APIs that happen to allocate Python + // objects) and some garbage had weakref callbacks or __del__ that + // switches (people don't write code like that by hand, but with + // gevent it's possible without realizing it) + assert(this->args() || PyErr_Occurred()); + { /* save state */ + if (this->thread_state()->is_current(this->self())) { + // Hmm, nothing to do. + // TODO: Does this bypass trace events that are + // important? + return switchstack_result_t(0, + this, this->thread_state()->borrow_current()); + } + BorrowedGreenlet current = this->thread_state()->borrow_current(); + PyThreadState* tstate = PyThreadState_GET(); + + current->python_state << tstate; + current->exception_state << tstate; + this->python_state.will_switch_from(tstate); + switching_thread_state = this; + current->expose_frames(); + } + assert(this->args() || PyErr_Occurred()); + // If this is the first switch into a greenlet, this will + // return twice, once with 1 in the new greenlet, once with 0 + // in the origin. + int err; + if (this->force_slp_switch_error()) { + err = -1; + } + else { + err = slp_switch(); + } + + if (err < 0) { /* error */ + // Tested by + // test_greenlet.TestBrokenGreenlets.test_failed_to_slp_switch_into_running + // + // It's not clear if it's worth trying to clean up and + // continue here. Failing to switch stacks is a big deal which + // may not be recoverable (who knows what state the stack is in). + // Also, we've stolen references in preparation for calling + // ``g_switchstack_success()`` and we don't have a clean + // mechanism for backing that all out. + Py_FatalError("greenlet: Failed low-level slp_switch(). The stack is probably corrupt."); + } + + // No stack-based variables are valid anymore. + + // But the global is volatile so we can reload it without the + // compiler caching it from earlier. + Greenlet* greenlet_that_switched_in = switching_thread_state; // aka this + switching_thread_state = nullptr; + // except that no stack variables are valid, we would: + // assert(this == greenlet_that_switched_in); + + // switchstack success is where we restore the exception state, + // etc. It returns the origin greenlet because its convenient. + + OwnedGreenlet origin = greenlet_that_switched_in->g_switchstack_success(); + assert(greenlet_that_switched_in->args() || PyErr_Occurred()); + return switchstack_result_t(err, greenlet_that_switched_in, origin); +} + + +inline void +Greenlet::check_switch_allowed() const +{ + // TODO: Make this take a parameter of the current greenlet, + // or current main greenlet, to make the check for + // cross-thread switching cheaper. Surely somewhere up the + // call stack we've already accessed the thread local variable. + + // We expect to always have a main greenlet now; accessing the thread state + // created it. However, if we get here and cleanup has already + // begun because we're a greenlet that was running in a + // (now dead) thread, these invariants will not hold true. In + // fact, accessing `this->thread_state` may not even be possible. + + // If the thread this greenlet was running in is dead, + // we'll still have a reference to a main greenlet, but the + // thread state pointer we have is bogus. + // TODO: Give the objects an API to determine if they belong + // to a dead thread. + + const BorrowedMainGreenlet main_greenlet = this->find_main_greenlet_in_lineage(); + + if (!main_greenlet) { + throw PyErrOccurred(mod_globs->PyExc_GreenletError, + "cannot switch to a garbage collected greenlet"); + } + + if (!main_greenlet->thread_state()) { + throw PyErrOccurred(mod_globs->PyExc_GreenletError, + "cannot switch to a different thread (which happens to have exited)"); + } + + // The main greenlet we found was from the .parent lineage. + // That may or may not have any relationship to the main + // greenlet of the running thread. We can't actually access + // our this->thread_state members to try to check that, + // because it could be in the process of getting destroyed, + // but setting the main_greenlet->thread_state member to NULL + // may not be visible yet. So we need to check against the + // current thread state (once the cheaper checks are out of + // the way) + const BorrowedMainGreenlet current_main_greenlet = GET_THREAD_STATE().state().borrow_main_greenlet(); + if ( + // lineage main greenlet is not this thread's greenlet + current_main_greenlet != main_greenlet + || ( + // atteched to some thread + this->main_greenlet() + // XXX: Same condition as above. Was this supposed to be + // this->main_greenlet()? + && current_main_greenlet != main_greenlet) + // switching into a known dead thread (XXX: which, if we get here, + // is bad, because we just accessed the thread state, which is + // gone!) + || (!current_main_greenlet->thread_state())) { + // CAUTION: This may trigger memory allocations, gc, and + // arbitrary Python code. + throw PyErrOccurred( + mod_globs->PyExc_GreenletError, + "Cannot switch to a different thread\n\tCurrent: %R\n\tExpected: %R", + current_main_greenlet, main_greenlet); + } +} + +const OwnedObject +Greenlet::context() const +{ + using greenlet::PythonStateContext; + OwnedObject result; + + if (this->is_currently_running_in_some_thread()) { + /* Currently running greenlet: context is stored in the thread state, + not the greenlet object. */ + if (GET_THREAD_STATE().state().is_current(this->self())) { + result = PythonStateContext::context(PyThreadState_GET()); + } + else { + throw ValueError( + "cannot get context of a " + "greenlet that is running in a different thread"); + } + } + else { + /* Greenlet is not running: just return context. */ + result = this->python_state.context(); + } + if (!result) { + result = OwnedObject::None(); + } + return result; +} + + +void +Greenlet::context(BorrowedObject given) +{ + using greenlet::PythonStateContext; + if (!given) { + throw AttributeError("can't delete context attribute"); + } + if (given.is_None()) { + /* "Empty context" is stored as NULL, not None. */ + given = nullptr; + } + + //checks type, incrs refcnt + greenlet::refs::OwnedContext context(given); + PyThreadState* tstate = PyThreadState_GET(); + + if (this->is_currently_running_in_some_thread()) { + if (!GET_THREAD_STATE().state().is_current(this->self())) { + throw ValueError("cannot set context of a greenlet" + " that is running in a different thread"); + } + + /* Currently running greenlet: context is stored in the thread state, + not the greenlet object. */ + OwnedObject octx = OwnedObject::consuming(PythonStateContext::context(tstate)); + PythonStateContext::context(tstate, context.relinquish_ownership()); + } + else { + /* Greenlet is not running: just set context. Note that the + greenlet may be dead.*/ + this->python_state.context() = context; + } +} + +/** + * CAUTION: May invoke arbitrary Python code. + * + * Figure out what the result of ``greenlet.switch(arg, kwargs)`` + * should be and transfers ownership of it to the left-hand-side. + * + * If switch() was just passed an arg tuple, then we'll just return that. + * If only keyword arguments were passed, then we'll pass the keyword + * argument dict. Otherwise, we'll create a tuple of (args, kwargs) and + * return both. + * + * CAUTION: This may allocate a new tuple object, which may + * cause the Python garbage collector to run, which in turn may + * run arbitrary Python code that switches. + */ +OwnedObject& operator<<=(OwnedObject& lhs, greenlet::SwitchingArgs& rhs) noexcept +{ + // Because this may invoke arbitrary Python code, which could + // result in switching back to us, we need to get the + // arguments locally on the stack. + assert(rhs); + OwnedObject args = rhs.args(); + OwnedObject kwargs = rhs.kwargs(); + rhs.CLEAR(); + // We shouldn't be called twice for the same switch. + assert(args || kwargs); + assert(!rhs); + + if (!kwargs) { + lhs = args; + } + else if (!PyDict_Size(kwargs.borrow())) { + lhs = args; + } + else if (!PySequence_Length(args.borrow())) { + lhs = kwargs; + } + else { + // PyTuple_Pack allocates memory, may GC, may run arbitrary + // Python code. + lhs = OwnedObject::consuming(PyTuple_Pack(2, args.borrow(), kwargs.borrow())); + } + return lhs; +} + +static OwnedObject +g_handle_exit(const OwnedObject& greenlet_result) +{ + if (!greenlet_result && mod_globs->PyExc_GreenletExit.PyExceptionMatches()) { + /* catch and ignore GreenletExit */ + PyErrFetchParam val; + PyErr_Fetch(PyErrFetchParam(), val, PyErrFetchParam()); + if (!val) { + return OwnedObject::None(); + } + return OwnedObject(val); + } + + if (greenlet_result) { + // package the result into a 1-tuple + // PyTuple_Pack increments the reference of its arguments, + // so we always need to decref the greenlet result; + // the owner will do that. + return OwnedObject::consuming(PyTuple_Pack(1, greenlet_result.borrow())); + } + + return OwnedObject(); +} + + + +/** + * May run arbitrary Python code. + */ +OwnedObject +Greenlet::g_switch_finish(const switchstack_result_t& err) +{ + assert(err.the_new_current_greenlet == this); + + ThreadState& state = *this->thread_state(); + // Because calling the trace function could do arbitrary things, + // including switching away from this greenlet and then maybe + // switching back, we need to capture the arguments now so that + // they don't change. + OwnedObject result; + if (this->args()) { + result <<= this->args(); + } + else { + assert(PyErr_Occurred()); + } + assert(!this->args()); + try { + // Our only caller handles the bad error case + assert(err.status >= 0); + assert(state.borrow_current() == this->self()); + if (OwnedObject tracefunc = state.get_tracefunc()) { + assert(result || PyErr_Occurred()); + g_calltrace(tracefunc, + result ? mod_globs->event_switch : mod_globs->event_throw, + err.origin_greenlet, + this->self()); + } + // The above could have invoked arbitrary Python code, but + // it couldn't switch back to this object and *also* + // throw an exception, so the args won't have changed. + + if (PyErr_Occurred()) { + // We get here if we fell of the end of the run() function + // raising an exception. The switch itself was + // successful, but the function raised. + // valgrind reports that memory allocated here can still + // be reached after a test run. + throw PyErrOccurred::from_current(); + } + return result; + } + catch (const PyErrOccurred&) { + /* Turn switch errors into switch throws */ + /* Turn trace errors into switch throws */ + this->release_args(); + throw; + } +} + +void +Greenlet::g_calltrace(const OwnedObject& tracefunc, + const greenlet::refs::ImmortalEventName& event, + const BorrowedGreenlet& origin, + const BorrowedGreenlet& target) +{ + PyErrPieces saved_exc; + try { + TracingGuard tracing_guard; + // TODO: We have saved the active exception (if any) that's + // about to be raised. In the 'throw' case, we could provide + // the exception to the tracefunction, which seems very helpful. + tracing_guard.CallTraceFunction(tracefunc, event, origin, target); + } + catch (const PyErrOccurred&) { + // In case of exceptions trace function is removed, + // and any existing exception is replaced with the tracing + // exception. + GET_THREAD_STATE().state().set_tracefunc(Py_None); + throw; + } + + saved_exc.PyErrRestore(); + assert( + (event == mod_globs->event_throw && PyErr_Occurred()) + || (event == mod_globs->event_switch && !PyErr_Occurred()) + ); +} + +void +Greenlet::murder_in_place() +{ + if (this->active()) { + assert(!this->is_currently_running_in_some_thread()); + this->deactivate_and_free(); + } +} + +inline void +Greenlet::deactivate_and_free() +{ + if (!this->active()) { + return; + } + // Throw away any saved stack. + this->stack_state = StackState(); + assert(!this->stack_state.active()); + // Throw away any Python references. + // We're holding a borrowed reference to the last + // frame we executed. Since we borrowed it, the + // normal traversal, clear, and dealloc functions + // ignore it, meaning it leaks. (The thread state + // object can't find it to clear it when that's + // deallocated either, because by definition if we + // got an object on this list, it wasn't + // running and the thread state doesn't have + // this frame.) + // So here, we *do* clear it. + this->python_state.tp_clear(true); +} + +bool +Greenlet::belongs_to_thread(const ThreadState* thread_state) const +{ + if (!this->thread_state() // not running anywhere, or thread + // exited + || !thread_state) { // same, or there is no thread state. + return false; + } + return true; +} + + +void +Greenlet::deallocing_greenlet_in_thread(const ThreadState* current_thread_state) +{ + /* Cannot raise an exception to kill the greenlet if + it is not running in the same thread! */ + if (this->belongs_to_thread(current_thread_state)) { + assert(current_thread_state); + // To get here it had to have run before + /* Send the greenlet a GreenletExit exception. */ + + // We don't care about the return value, only whether an + // exception happened. + this->throw_GreenletExit_during_dealloc(*current_thread_state); + return; + } + + // Not the same thread! Temporarily save the greenlet + // into its thread's deleteme list, *if* it exists. + // If that thread has already exited, and processed its pending + // cleanup, we'll never be able to clean everything up: we won't + // be able to raise an exception. + // That's mostly OK! Since we can't add it to a list, our refcount + // won't increase, and we'll go ahead with the DECREFs later. + ThreadState *const thread_state = this->thread_state(); + if (thread_state) { + thread_state->delete_when_thread_running(this->self()); + } + else { + // The thread is dead, we can't raise an exception. + // We need to make it look non-active, though, so that dealloc + // finishes killing it. + this->deactivate_and_free(); + } + return; +} + + +int +Greenlet::tp_traverse(visitproc visit, void* arg) +{ + + int result; + if ((result = this->exception_state.tp_traverse(visit, arg)) != 0) { + return result; + } + //XXX: This is ugly. But so is handling everything having to do + //with the top frame. + bool visit_top_frame = this->was_running_in_dead_thread(); + // When true, the thread is dead. Our implicit weak reference to the + // frame is now all that's left; we consider ourselves to + // strongly own it now. + if ((result = this->python_state.tp_traverse(visit, arg, visit_top_frame)) != 0) { + return result; + } + return 0; +} + +int +Greenlet::tp_clear() +{ + bool own_top_frame = this->was_running_in_dead_thread(); + this->exception_state.tp_clear(); + this->python_state.tp_clear(own_top_frame); + return 0; +} + +bool Greenlet::is_currently_running_in_some_thread() const +{ + return this->stack_state.active() && !this->python_state.top_frame(); +} + +#if GREENLET_PY312 +void GREENLET_NOINLINE(Greenlet::expose_frames)() +{ + if (!this->python_state.top_frame()) { + return; + } + + _PyInterpreterFrame* last_complete_iframe = nullptr; + _PyInterpreterFrame* iframe = this->python_state.top_frame()->f_frame; + while (iframe) { + // We must make a copy before looking at the iframe contents, + // since iframe might point to a portion of the greenlet's C stack + // that was spilled when switching greenlets. + _PyInterpreterFrame iframe_copy; + this->stack_state.copy_from_stack(&iframe_copy, iframe, sizeof(*iframe)); + if (!_PyFrame_IsIncomplete(&iframe_copy)) { + // If the iframe were OWNED_BY_CSTACK then it would always be + // incomplete. Since it's not incomplete, it's not on the C stack + // and we can access it through the original `iframe` pointer + // directly. This is important since GetFrameObject might + // lazily _create_ the frame object and we don't want the + // interpreter to lose track of it. + assert(iframe_copy.owner != FRAME_OWNED_BY_CSTACK); + + // We really want to just write: + // PyFrameObject* frame = _PyFrame_GetFrameObject(iframe); + // but _PyFrame_GetFrameObject calls _PyFrame_MakeAndSetFrameObject + // which is not a visible symbol in libpython. The easiest + // way to get a public function to call it is using + // PyFrame_GetBack, which is defined as follows: + // assert(frame != NULL); + // assert(!_PyFrame_IsIncomplete(frame->f_frame)); + // PyFrameObject *back = frame->f_back; + // if (back == NULL) { + // _PyInterpreterFrame *prev = frame->f_frame->previous; + // prev = _PyFrame_GetFirstComplete(prev); + // if (prev) { + // back = _PyFrame_GetFrameObject(prev); + // } + // } + // return (PyFrameObject*)Py_XNewRef(back); + if (!iframe->frame_obj) { + PyFrameObject dummy_frame; + _PyInterpreterFrame dummy_iframe; + dummy_frame.f_back = nullptr; + dummy_frame.f_frame = &dummy_iframe; + // force the iframe to be considered complete without + // needing to check its code object: + dummy_iframe.owner = FRAME_OWNED_BY_GENERATOR; + dummy_iframe.previous = iframe; + assert(!_PyFrame_IsIncomplete(&dummy_iframe)); + // Drop the returned reference immediately; the iframe + // continues to hold a strong reference + Py_XDECREF(PyFrame_GetBack(&dummy_frame)); + assert(iframe->frame_obj); + } + + // This is a complete frame, so make the last one of those we saw + // point at it, bypassing any incomplete frames (which may have + // been on the C stack) in between the two. We're overwriting + // last_complete_iframe->previous and need that to be reversible, + // so we store the original previous ptr in the frame object + // (which we must have created on a previous iteration through + // this loop). The frame object has a bunch of storage that is + // only used when its iframe is OWNED_BY_FRAME_OBJECT, which only + // occurs when the frame object outlives the frame's execution, + // which can't have happened yet because the frame is currently + // executing as far as the interpreter is concerned. So, we can + // reuse it for our own purposes. + assert(iframe->owner == FRAME_OWNED_BY_THREAD + || iframe->owner == FRAME_OWNED_BY_GENERATOR); + if (last_complete_iframe) { + assert(last_complete_iframe->frame_obj); + memcpy(&last_complete_iframe->frame_obj->_f_frame_data[0], + &last_complete_iframe->previous, sizeof(void *)); + last_complete_iframe->previous = iframe; + } + last_complete_iframe = iframe; + } + // Frames that are OWNED_BY_FRAME_OBJECT are linked via the + // frame's f_back while all others are linked via the iframe's + // previous ptr. Since all the frames we traverse are running + // as far as the interpreter is concerned, we don't have to + // worry about the OWNED_BY_FRAME_OBJECT case. + iframe = iframe_copy.previous; + } + + // Give the outermost complete iframe a null previous pointer to + // account for any potential incomplete/C-stack iframes between it + // and the actual top-of-stack + if (last_complete_iframe) { + assert(last_complete_iframe->frame_obj); + memcpy(&last_complete_iframe->frame_obj->_f_frame_data[0], + &last_complete_iframe->previous, sizeof(void *)); + last_complete_iframe->previous = nullptr; + } +} +#else +void Greenlet::expose_frames() +{ + +} +#endif + +}; // namespace greenlet +#endif diff --git a/.venv/Lib/site-packages/greenlet/TGreenlet.hpp b/.venv/Lib/site-packages/greenlet/TGreenlet.hpp new file mode 100644 index 0000000..512f7fb --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TGreenlet.hpp @@ -0,0 +1,813 @@ +#ifndef GREENLET_GREENLET_HPP +#define GREENLET_GREENLET_HPP +/* + * Declarations of the core data structures. +*/ + +#define PY_SSIZE_T_CLEAN +#include + +#include "greenlet_compiler_compat.hpp" +#include "greenlet_refs.hpp" +#include "greenlet_cpython_compat.hpp" +#include "greenlet_allocator.hpp" + +using greenlet::refs::OwnedObject; +using greenlet::refs::OwnedGreenlet; +using greenlet::refs::OwnedMainGreenlet; +using greenlet::refs::BorrowedGreenlet; + +#if PY_VERSION_HEX < 0x30B00A6 +# define _PyCFrame CFrame +# define _PyInterpreterFrame _interpreter_frame +#endif + +#if GREENLET_PY312 +# define Py_BUILD_CORE +# include "internal/pycore_frame.h" +#endif + +// XXX: TODO: Work to remove all virtual functions +// for speed of calling and size of objects (no vtable). +// One pattern is the Curiously Recurring Template +namespace greenlet +{ + class ExceptionState + { + private: + G_NO_COPIES_OF_CLS(ExceptionState); + + // Even though these are borrowed objects, we actually own + // them, when they're not null. + // XXX: Express that in the API. + private: + _PyErr_StackItem* exc_info; + _PyErr_StackItem exc_state; + public: + ExceptionState(); + void operator<<(const PyThreadState *const tstate) noexcept; + void operator>>(PyThreadState* tstate) noexcept; + void clear() noexcept; + + int tp_traverse(visitproc visit, void* arg) noexcept; + void tp_clear() noexcept; + }; + + template + void operator<<(const PyThreadState *const tstate, T& exc); + + class PythonStateContext + { + protected: + greenlet::refs::OwnedContext _context; + public: + inline const greenlet::refs::OwnedContext& context() const + { + return this->_context; + } + inline greenlet::refs::OwnedContext& context() + { + return this->_context; + } + + inline void tp_clear() + { + this->_context.CLEAR(); + } + + template + inline static PyObject* context(T* tstate) + { + return tstate->context; + } + + template + inline static void context(T* tstate, PyObject* new_context) + { + tstate->context = new_context; + tstate->context_ver++; + } + }; + class SwitchingArgs; + class PythonState : public PythonStateContext + { + public: + typedef greenlet::refs::OwnedReference OwnedFrame; + private: + G_NO_COPIES_OF_CLS(PythonState); + // We own this if we're suspended (although currently we don't + // tp_traverse into it; that's a TODO). If we're running, it's + // empty. If we get deallocated and *still* have a frame, it + // won't be reachable from the place that normally decref's + // it, so we need to do it (hence owning it). + OwnedFrame _top_frame; +#if GREENLET_USE_CFRAME + _PyCFrame* cframe; + int use_tracing; +#endif +#if GREENLET_PY312 + int py_recursion_depth; + int c_recursion_depth; +#else + int recursion_depth; +#endif +#if GREENLET_PY313 + PyObject *delete_later; +#else + int trash_delete_nesting; +#endif +#if GREENLET_PY311 + _PyInterpreterFrame* current_frame; + _PyStackChunk* datastack_chunk; + PyObject** datastack_top; + PyObject** datastack_limit; +#endif + // The PyInterpreterFrame list on 3.12+ contains some entries that are + // on the C stack, which can't be directly accessed while a greenlet is + // suspended. In order to keep greenlet gr_frame introspection working, + // we adjust stack switching to rewrite the interpreter frame list + // to skip these C-stack frames; we call this "exposing" the greenlet's + // frames because it makes them valid to work with in Python. Then when + // the greenlet is resumed we need to remember to reverse the operation + // we did. The C-stack frames are "entry frames" which are a low-level + // interpreter detail; they're not needed for introspection, but do + // need to be present for the eval loop to work. + void unexpose_frames(); + + public: + + PythonState(); + // You can use this for testing whether we have a frame + // or not. It returns const so they can't modify it. + const OwnedFrame& top_frame() const noexcept; + + inline void operator<<(const PyThreadState *const tstate) noexcept; + inline void operator>>(PyThreadState* tstate) noexcept; + void clear() noexcept; + + int tp_traverse(visitproc visit, void* arg, bool visit_top_frame) noexcept; + void tp_clear(bool own_top_frame) noexcept; + void set_initial_state(const PyThreadState* const tstate) noexcept; +#if GREENLET_USE_CFRAME + void set_new_cframe(_PyCFrame& frame) noexcept; +#endif + + void may_switch_away() noexcept; + inline void will_switch_from(PyThreadState *const origin_tstate) noexcept; + void did_finish(PyThreadState* tstate) noexcept; + }; + + class StackState + { + // By having only plain C (POD) members, no virtual functions + // or bases, we get a trivial assignment operator generated + // for us. However, that's not safe since we do manage memory. + // So we declare an assignment operator that only works if we + // don't have any memory allocated. (We don't use + // std::shared_ptr for reference counting just to keep this + // object small) + private: + char* _stack_start; + char* stack_stop; + char* stack_copy; + intptr_t _stack_saved; + StackState* stack_prev; + inline int copy_stack_to_heap_up_to(const char* const stop) noexcept; + inline void free_stack_copy() noexcept; + + public: + /** + * Creates a started, but inactive, state, using *current* + * as the previous. + */ + StackState(void* mark, StackState& current); + /** + * Creates an inactive, unstarted, state. + */ + StackState(); + ~StackState(); + StackState(const StackState& other); + StackState& operator=(const StackState& other); + inline void copy_heap_to_stack(const StackState& current) noexcept; + inline int copy_stack_to_heap(char* const stackref, const StackState& current) noexcept; + inline bool started() const noexcept; + inline bool main() const noexcept; + inline bool active() const noexcept; + inline void set_active() noexcept; + inline void set_inactive() noexcept; + inline intptr_t stack_saved() const noexcept; + inline char* stack_start() const noexcept; + static inline StackState make_main() noexcept; +#ifdef GREENLET_USE_STDIO + friend std::ostream& operator<<(std::ostream& os, const StackState& s); +#endif + + // Fill in [dest, dest + n) with the values that would be at + // [src, src + n) while this greenlet is running. This is like memcpy + // except that if the greenlet is suspended it accounts for the portion + // of the greenlet's stack that was spilled to the heap. `src` may + // be on this greenlet's stack, or on the heap, but not on a different + // greenlet's stack. + void copy_from_stack(void* dest, const void* src, size_t n) const; + }; +#ifdef GREENLET_USE_STDIO + std::ostream& operator<<(std::ostream& os, const StackState& s); +#endif + + class SwitchingArgs + { + private: + G_NO_ASSIGNMENT_OF_CLS(SwitchingArgs); + // If args and kwargs are both false (NULL), this is a *throw*, not a + // switch. PyErr_... must have been called already. + OwnedObject _args; + OwnedObject _kwargs; + public: + + SwitchingArgs() + {} + + SwitchingArgs(const OwnedObject& args, const OwnedObject& kwargs) + : _args(args), + _kwargs(kwargs) + {} + + SwitchingArgs(const SwitchingArgs& other) + : _args(other._args), + _kwargs(other._kwargs) + {} + + const OwnedObject& args() + { + return this->_args; + } + + const OwnedObject& kwargs() + { + return this->_kwargs; + } + + /** + * Moves ownership from the argument to this object. + */ + SwitchingArgs& operator<<=(SwitchingArgs& other) + { + if (this != &other) { + this->_args = other._args; + this->_kwargs = other._kwargs; + other.CLEAR(); + } + return *this; + } + + /** + * Acquires ownership of the argument (consumes the reference). + */ + SwitchingArgs& operator<<=(PyObject* args) + { + this->_args = OwnedObject::consuming(args); + this->_kwargs.CLEAR(); + return *this; + } + + /** + * Acquires ownership of the argument. + * + * Sets the args to be the given value; clears the kwargs. + */ + SwitchingArgs& operator<<=(OwnedObject& args) + { + assert(&args != &this->_args); + this->_args = args; + this->_kwargs.CLEAR(); + args.CLEAR(); + + return *this; + } + + explicit operator bool() const noexcept + { + return this->_args || this->_kwargs; + } + + inline void CLEAR() + { + this->_args.CLEAR(); + this->_kwargs.CLEAR(); + } + + const std::string as_str() const noexcept + { + return PyUnicode_AsUTF8( + OwnedObject::consuming( + PyUnicode_FromFormat( + "SwitchingArgs(args=%R, kwargs=%R)", + this->_args.borrow(), + this->_kwargs.borrow() + ) + ).borrow() + ); + } + }; + + class ThreadState; + + class UserGreenlet; + class MainGreenlet; + + class Greenlet + { + private: + G_NO_COPIES_OF_CLS(Greenlet); + PyGreenlet* const _self; + private: + // XXX: Work to remove these. + friend class ThreadState; + friend class UserGreenlet; + friend class MainGreenlet; + protected: + ExceptionState exception_state; + SwitchingArgs switch_args; + StackState stack_state; + PythonState python_state; + Greenlet(PyGreenlet* p, const StackState& initial_state); + public: + // This constructor takes ownership of the PyGreenlet, by + // setting ``p->pimpl = this;``. + Greenlet(PyGreenlet* p); + virtual ~Greenlet(); + + const OwnedObject context() const; + + // You MUST call this _very_ early in the switching process to + // prepare anything that may need prepared. This might perform + // garbage collections or otherwise run arbitrary Python code. + // + // One specific use of it is for Python 3.11+, preventing + // running arbitrary code at unsafe times. See + // PythonState::may_switch_away(). + inline void may_switch_away() + { + this->python_state.may_switch_away(); + } + + inline void context(refs::BorrowedObject new_context); + + inline SwitchingArgs& args() + { + return this->switch_args; + } + + virtual const refs::BorrowedMainGreenlet main_greenlet() const = 0; + + inline intptr_t stack_saved() const noexcept + { + return this->stack_state.stack_saved(); + } + + // This is used by the macro SLP_SAVE_STATE to compute the + // difference in stack sizes. It might be nice to handle the + // computation ourself, but the type of the result + // varies by platform, so doing it in the macro is the + // simplest way. + inline const char* stack_start() const noexcept + { + return this->stack_state.stack_start(); + } + + virtual OwnedObject throw_GreenletExit_during_dealloc(const ThreadState& current_thread_state); + virtual OwnedObject g_switch() = 0; + /** + * Force the greenlet to appear dead. Used when it's not + * possible to throw an exception into a greenlet anymore. + * + * This losses access to the thread state and the main greenlet. + */ + virtual void murder_in_place(); + + /** + * Called when somebody notices we were running in a dead + * thread to allow cleaning up resources (because we can't + * raise GreenletExit into it anymore). + * This is very similar to ``murder_in_place()``, except that + * it DOES NOT lose the main greenlet or thread state. + */ + inline void deactivate_and_free(); + + + // Called when some thread wants to deallocate a greenlet + // object. + // The thread may or may not be the same thread the greenlet + // was running in. + // The thread state will be null if the thread the greenlet + // was running in was known to have exited. + void deallocing_greenlet_in_thread(const ThreadState* current_state); + + // Must be called on 3.12+ before exposing a suspended greenlet's + // frames to user code. This rewrites the linked list of interpreter + // frames to skip the ones that are being stored on the C stack (which + // can't be safely accessed while the greenlet is suspended because + // that stack space might be hosting a different greenlet), and + // sets PythonState::frames_were_exposed so we remember to restore + // the original list before resuming the greenlet. The C-stack frames + // are a low-level interpreter implementation detail; while they're + // important to the bytecode eval loop, they're superfluous for + // introspection purposes. + void expose_frames(); + + + // TODO: Figure out how to make these non-public. + inline void slp_restore_state() noexcept; + inline int slp_save_state(char *const stackref) noexcept; + + inline bool is_currently_running_in_some_thread() const; + virtual bool belongs_to_thread(const ThreadState* state) const; + + inline bool started() const + { + return this->stack_state.started(); + } + inline bool active() const + { + return this->stack_state.active(); + } + inline bool main() const + { + return this->stack_state.main(); + } + virtual refs::BorrowedMainGreenlet find_main_greenlet_in_lineage() const = 0; + + virtual const OwnedGreenlet parent() const = 0; + virtual void parent(const refs::BorrowedObject new_parent) = 0; + + inline const PythonState::OwnedFrame& top_frame() + { + return this->python_state.top_frame(); + } + + virtual const OwnedObject& run() const = 0; + virtual void run(const refs::BorrowedObject nrun) = 0; + + + virtual int tp_traverse(visitproc visit, void* arg); + virtual int tp_clear(); + + + // Return the thread state that the greenlet is running in, or + // null if the greenlet is not running or the thread is known + // to have exited. + virtual ThreadState* thread_state() const noexcept = 0; + + // Return true if the greenlet is known to have been running + // (active) in a thread that has now exited. + virtual bool was_running_in_dead_thread() const noexcept = 0; + + // Return a borrowed greenlet that is the Python object + // this object represents. + inline BorrowedGreenlet self() const noexcept + { + return BorrowedGreenlet(this->_self); + } + + // For testing. If this returns true, we should pretend that + // slp_switch() failed. + virtual bool force_slp_switch_error() const noexcept; + + protected: + inline void release_args(); + + // The functions that must not be inlined are declared virtual. + // We also mark them as protected, not private, so that the + // compiler is forced to call them through a function pointer. + // (A sufficiently smart compiler could directly call a private + // virtual function since it can never be overridden in a + // subclass). + + // Also TODO: Switch away from integer error codes and to enums, + // or throw exceptions when possible. + struct switchstack_result_t + { + int status; + Greenlet* the_new_current_greenlet; + OwnedGreenlet origin_greenlet; + + switchstack_result_t() + : status(0), + the_new_current_greenlet(nullptr) + {} + + switchstack_result_t(int err) + : status(err), + the_new_current_greenlet(nullptr) + {} + + switchstack_result_t(int err, Greenlet* state, OwnedGreenlet& origin) + : status(err), + the_new_current_greenlet(state), + origin_greenlet(origin) + { + } + + switchstack_result_t(int err, Greenlet* state, const BorrowedGreenlet& origin) + : status(err), + the_new_current_greenlet(state), + origin_greenlet(origin) + { + } + + switchstack_result_t(const switchstack_result_t& other) + : status(other.status), + the_new_current_greenlet(other.the_new_current_greenlet), + origin_greenlet(other.origin_greenlet) + {} + + switchstack_result_t& operator=(const switchstack_result_t& other) + { + this->status = other.status; + this->the_new_current_greenlet = other.the_new_current_greenlet; + this->origin_greenlet = other.origin_greenlet; + return *this; + } + }; + + OwnedObject on_switchstack_or_initialstub_failure( + Greenlet* target, + const switchstack_result_t& err, + const bool target_was_me=false, + const bool was_initial_stub=false); + + // Returns the previous greenlet we just switched away from. + virtual OwnedGreenlet g_switchstack_success() noexcept; + + + // Check the preconditions for switching to this greenlet; if they + // aren't met, throws PyErrOccurred. Most callers will want to + // catch this and clear the arguments + inline void check_switch_allowed() const; + class GreenletStartedWhileInPython : public std::runtime_error + { + public: + GreenletStartedWhileInPython() : std::runtime_error("") + {} + }; + + protected: + + + /** + Perform a stack switch into this greenlet. + + This temporarily sets the global variable + ``switching_thread_state`` to this greenlet; as soon as the + call to ``slp_switch`` completes, this is reset to NULL. + Consequently, this depends on the GIL. + + TODO: Adopt the stackman model and pass ``slp_switch`` a + callback function and context pointer; this eliminates the + need for global variables altogether. + + Because the stack switch happens in this function, this + function can't use its own stack (local) variables, set + before the switch, and then accessed after the switch. + + Further, you con't even access ``g_thread_state_global`` + before and after the switch from the global variable. + Because it is thread local some compilers cache it in a + register/on the stack, notably new versions of MSVC; this + breaks with strange crashes sometime later, because writing + to anything in ``g_thread_state_global`` after the switch + is actually writing to random memory. For this reason, we + call a non-inlined function to finish the operation. (XXX: + The ``/GT`` MSVC compiler argument probably fixes that.) + + It is very important that stack switch is 'atomic', i.e. no + calls into other Python code allowed (except very few that + are safe), because global variables are very fragile. (This + should no longer be the case with thread-local variables.) + + */ + // Made virtual to facilitate subclassing UserGreenlet for testing. + virtual switchstack_result_t g_switchstack(void); + +class TracingGuard +{ +private: + PyThreadState* tstate; +public: + TracingGuard() + : tstate(PyThreadState_GET()) + { + PyThreadState_EnterTracing(this->tstate); + } + + ~TracingGuard() + { + PyThreadState_LeaveTracing(this->tstate); + this->tstate = nullptr; + } + + inline void CallTraceFunction(const OwnedObject& tracefunc, + const greenlet::refs::ImmortalEventName& event, + const BorrowedGreenlet& origin, + const BorrowedGreenlet& target) + { + // TODO: This calls tracefunc(event, (origin, target)). Add a shortcut + // function for that that's specialized to avoid the Py_BuildValue + // string parsing, or start with just using "ON" format with PyTuple_Pack(2, + // origin, target). That seems like what the N format is meant + // for. + // XXX: Why does event not automatically cast back to a PyObject? + // It tries to call the "deleted constructor ImmortalEventName + // const" instead. + assert(tracefunc); + assert(event); + assert(origin); + assert(target); + greenlet::refs::NewReference retval( + PyObject_CallFunction( + tracefunc.borrow(), + "O(OO)", + event.borrow(), + origin.borrow(), + target.borrow() + )); + if (!retval) { + throw PyErrOccurred::from_current(); + } + } +}; + + static void + g_calltrace(const OwnedObject& tracefunc, + const greenlet::refs::ImmortalEventName& event, + const greenlet::refs::BorrowedGreenlet& origin, + const BorrowedGreenlet& target); + private: + OwnedObject g_switch_finish(const switchstack_result_t& err); + + }; + + class UserGreenlet : public Greenlet + { + private: + static greenlet::PythonAllocator allocator; + OwnedMainGreenlet _main_greenlet; + OwnedObject _run_callable; + OwnedGreenlet _parent; + public: + static void* operator new(size_t UNUSED(count)); + static void operator delete(void* ptr); + + UserGreenlet(PyGreenlet* p, BorrowedGreenlet the_parent); + virtual ~UserGreenlet(); + + virtual refs::BorrowedMainGreenlet find_main_greenlet_in_lineage() const; + virtual bool was_running_in_dead_thread() const noexcept; + virtual ThreadState* thread_state() const noexcept; + virtual OwnedObject g_switch(); + virtual const OwnedObject& run() const + { + if (this->started() || !this->_run_callable) { + throw AttributeError("run"); + } + return this->_run_callable; + } + virtual void run(const refs::BorrowedObject nrun); + + virtual const OwnedGreenlet parent() const; + virtual void parent(const refs::BorrowedObject new_parent); + + virtual const refs::BorrowedMainGreenlet main_greenlet() const; + + virtual void murder_in_place(); + virtual bool belongs_to_thread(const ThreadState* state) const; + virtual int tp_traverse(visitproc visit, void* arg); + virtual int tp_clear(); + class ParentIsCurrentGuard + { + private: + OwnedGreenlet oldparent; + UserGreenlet* greenlet; + G_NO_COPIES_OF_CLS(ParentIsCurrentGuard); + public: + ParentIsCurrentGuard(UserGreenlet* p, const ThreadState& thread_state); + ~ParentIsCurrentGuard(); + }; + virtual OwnedObject throw_GreenletExit_during_dealloc(const ThreadState& current_thread_state); + protected: + virtual switchstack_result_t g_initialstub(void* mark); + private: + // This function isn't meant to return. + // This accepts raw pointers and the ownership of them at the + // same time. The caller should use ``inner_bootstrap(origin.relinquish_ownership())``. + void inner_bootstrap(PyGreenlet* origin_greenlet, PyObject* run); + }; + + class BrokenGreenlet : public UserGreenlet + { + private: + static greenlet::PythonAllocator allocator; + public: + bool _force_switch_error = false; + bool _force_slp_switch_error = false; + + static void* operator new(size_t UNUSED(count)); + static void operator delete(void* ptr); + BrokenGreenlet(PyGreenlet* p, BorrowedGreenlet the_parent) + : UserGreenlet(p, the_parent) + {} + virtual ~BrokenGreenlet() + {} + + virtual switchstack_result_t g_switchstack(void); + virtual bool force_slp_switch_error() const noexcept; + + }; + + class MainGreenlet : public Greenlet + { + private: + static greenlet::PythonAllocator allocator; + refs::BorrowedMainGreenlet _self; + ThreadState* _thread_state; + G_NO_COPIES_OF_CLS(MainGreenlet); + public: + static void* operator new(size_t UNUSED(count)); + static void operator delete(void* ptr); + + MainGreenlet(refs::BorrowedMainGreenlet::PyType*, ThreadState*); + virtual ~MainGreenlet(); + + + virtual const OwnedObject& run() const; + virtual void run(const refs::BorrowedObject nrun); + + virtual const OwnedGreenlet parent() const; + virtual void parent(const refs::BorrowedObject new_parent); + + virtual const refs::BorrowedMainGreenlet main_greenlet() const; + + virtual refs::BorrowedMainGreenlet find_main_greenlet_in_lineage() const; + virtual bool was_running_in_dead_thread() const noexcept; + virtual ThreadState* thread_state() const noexcept; + void thread_state(ThreadState*) noexcept; + virtual OwnedObject g_switch(); + virtual int tp_traverse(visitproc visit, void* arg); + }; + + // Instantiate one on the stack to save the GC state, + // and then disable GC. When it goes out of scope, GC will be + // restored to its original state. Sadly, these APIs are only + // available on 3.10+; luckily, we only need them on 3.11+. +#if GREENLET_PY310 + class GCDisabledGuard + { + private: + int was_enabled = 0; + public: + GCDisabledGuard() + : was_enabled(PyGC_IsEnabled()) + { + PyGC_Disable(); + } + + ~GCDisabledGuard() + { + if (this->was_enabled) { + PyGC_Enable(); + } + } + }; +#endif + + OwnedObject& operator<<=(OwnedObject& lhs, greenlet::SwitchingArgs& rhs) noexcept; + + //TODO: Greenlet::g_switch() should call this automatically on its + //return value. As it is, the module code is calling it. + static inline OwnedObject + single_result(const OwnedObject& results) + { + if (results + && PyTuple_Check(results.borrow()) + && PyTuple_GET_SIZE(results.borrow()) == 1) { + PyObject* result = PyTuple_GET_ITEM(results.borrow(), 0); + assert(result); + return OwnedObject::owning(result); + } + return results; + } + + + static OwnedObject + g_handle_exit(const OwnedObject& greenlet_result); + + + template + void operator<<(const PyThreadState *const lhs, T& rhs) + { + rhs.operator<<(lhs); + } + +} // namespace greenlet ; + +#endif diff --git a/.venv/Lib/site-packages/greenlet/TGreenletGlobals.cpp b/.venv/Lib/site-packages/greenlet/TGreenletGlobals.cpp new file mode 100644 index 0000000..0087d2f --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TGreenletGlobals.cpp @@ -0,0 +1,94 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + * Implementation of GreenletGlobals. + * + * Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ +#ifndef T_GREENLET_GLOBALS +#define T_GREENLET_GLOBALS + +#include "greenlet_refs.hpp" +#include "greenlet_exceptions.hpp" +#include "greenlet_thread_support.hpp" +#include "greenlet_internal.hpp" + +namespace greenlet { + +// This encapsulates what were previously module global "constants" +// established at init time. +// This is a step towards Python3 style module state that allows +// reloading. +// +// In an earlier iteration of this code, we used placement new to be +// able to allocate this object statically still, so that references +// to its members don't incur an extra pointer indirection. +// But under some scenarios, that could result in crashes at +// shutdown because apparently the destructor was getting run twice? +class GreenletGlobals +{ + +public: + const greenlet::refs::ImmortalEventName event_switch; + const greenlet::refs::ImmortalEventName event_throw; + const greenlet::refs::ImmortalException PyExc_GreenletError; + const greenlet::refs::ImmortalException PyExc_GreenletExit; + const greenlet::refs::ImmortalObject empty_tuple; + const greenlet::refs::ImmortalObject empty_dict; + const greenlet::refs::ImmortalString str_run; + Mutex* const thread_states_to_destroy_lock; + greenlet::cleanup_queue_t thread_states_to_destroy; + + GreenletGlobals() : + event_switch("switch"), + event_throw("throw"), + PyExc_GreenletError("greenlet.error"), + PyExc_GreenletExit("greenlet.GreenletExit", PyExc_BaseException), + empty_tuple(Require(PyTuple_New(0))), + empty_dict(Require(PyDict_New())), + str_run("run"), + thread_states_to_destroy_lock(new Mutex()) + {} + + ~GreenletGlobals() + { + // This object is (currently) effectively immortal, and not + // just because of those placement new tricks; if we try to + // deallocate the static object we allocated, and overwrote, + // we would be doing so at C++ teardown time, which is after + // the final Python GIL is released, and we can't use the API + // then. + // (The members will still be destructed, but they also don't + // do any deallocation.) + } + + void queue_to_destroy(ThreadState* ts) const + { + // we're currently accessed through a static const object, + // implicitly marking our members as const, so code can't just + // call push_back (or pop_back) without casting away the + // const. + // + // Do that for callers. + greenlet::cleanup_queue_t& q = const_cast(this->thread_states_to_destroy); + q.push_back(ts); + } + + ThreadState* take_next_to_destroy() const + { + greenlet::cleanup_queue_t& q = const_cast(this->thread_states_to_destroy); + ThreadState* result = q.back(); + q.pop_back(); + return result; + } +}; + +}; // namespace greenlet + +static const greenlet::GreenletGlobals* mod_globs; + +#endif // T_GREENLET_GLOBALS diff --git a/.venv/Lib/site-packages/greenlet/TMainGreenlet.cpp b/.venv/Lib/site-packages/greenlet/TMainGreenlet.cpp new file mode 100644 index 0000000..a2a9cfe --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TMainGreenlet.cpp @@ -0,0 +1,153 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + * Implementation of greenlet::MainGreenlet. + * + * Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ +#ifndef T_MAIN_GREENLET_CPP +#define T_MAIN_GREENLET_CPP + +#include "TGreenlet.hpp" + + + +// Protected by the GIL. Incremented when we create a main greenlet, +// in a new thread, decremented when it is destroyed. +static Py_ssize_t G_TOTAL_MAIN_GREENLETS; + +namespace greenlet { +greenlet::PythonAllocator MainGreenlet::allocator; + +void* MainGreenlet::operator new(size_t UNUSED(count)) +{ + return allocator.allocate(1); +} + + +void MainGreenlet::operator delete(void* ptr) +{ + return allocator.deallocate(static_cast(ptr), + 1); +} + + +MainGreenlet::MainGreenlet(PyGreenlet* p, ThreadState* state) + : Greenlet(p, StackState::make_main()), + _self(p), + _thread_state(state) +{ + G_TOTAL_MAIN_GREENLETS++; +} + +MainGreenlet::~MainGreenlet() +{ + G_TOTAL_MAIN_GREENLETS--; + this->tp_clear(); +} + +ThreadState* +MainGreenlet::thread_state() const noexcept +{ + return this->_thread_state; +} + +void +MainGreenlet::thread_state(ThreadState* t) noexcept +{ + assert(!t); + this->_thread_state = t; +} + + +const BorrowedMainGreenlet +MainGreenlet::main_greenlet() const +{ + return this->_self; +} + +BorrowedMainGreenlet +MainGreenlet::find_main_greenlet_in_lineage() const +{ + return BorrowedMainGreenlet(this->_self); +} + +bool +MainGreenlet::was_running_in_dead_thread() const noexcept +{ + return !this->_thread_state; +} + +OwnedObject +MainGreenlet::g_switch() +{ + try { + this->check_switch_allowed(); + } + catch (const PyErrOccurred&) { + this->release_args(); + throw; + } + + switchstack_result_t err = this->g_switchstack(); + if (err.status < 0) { + // XXX: This code path is untested, but it is shared + // with the UserGreenlet path that is tested. + return this->on_switchstack_or_initialstub_failure( + this, + err, + true, // target was me + false // was initial stub + ); + } + + return err.the_new_current_greenlet->g_switch_finish(err); +} + +int +MainGreenlet::tp_traverse(visitproc visit, void* arg) +{ + if (this->_thread_state) { + // we've already traversed main, (self), don't do it again. + int result = this->_thread_state->tp_traverse(visit, arg, false); + if (result) { + return result; + } + } + return Greenlet::tp_traverse(visit, arg); +} + +const OwnedObject& +MainGreenlet::run() const +{ + throw AttributeError("Main greenlets do not have a run attribute."); +} + +void +MainGreenlet::run(const BorrowedObject UNUSED(nrun)) +{ + throw AttributeError("Main greenlets do not have a run attribute."); +} + +void +MainGreenlet::parent(const BorrowedObject raw_new_parent) +{ + if (!raw_new_parent) { + throw AttributeError("can't delete attribute"); + } + throw AttributeError("cannot set the parent of a main greenlet"); +} + +const OwnedGreenlet +MainGreenlet::parent() const +{ + return OwnedGreenlet(); // null becomes None +} + +}; // namespace greenlet + +#endif diff --git a/.venv/Lib/site-packages/greenlet/TPythonState.cpp b/.venv/Lib/site-packages/greenlet/TPythonState.cpp new file mode 100644 index 0000000..cc5dff5 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TPythonState.cpp @@ -0,0 +1,393 @@ +#ifndef GREENLET_PYTHON_STATE_CPP +#define GREENLET_PYTHON_STATE_CPP + +#include +#include "TGreenlet.hpp" + +namespace greenlet { + +PythonState::PythonState() + : _top_frame() +#if GREENLET_USE_CFRAME + ,cframe(nullptr) + ,use_tracing(0) +#endif +#if GREENLET_PY312 + ,py_recursion_depth(0) + ,c_recursion_depth(0) +#else + ,recursion_depth(0) +#endif +#if GREENLET_PY313 + ,delete_later(nullptr) +#else + ,trash_delete_nesting(0) +#endif +#if GREENLET_PY311 + ,current_frame(nullptr) + ,datastack_chunk(nullptr) + ,datastack_top(nullptr) + ,datastack_limit(nullptr) +#endif +{ +#if GREENLET_USE_CFRAME + /* + The PyThreadState->cframe pointer usually points to memory on + the stack, alloceted in a call into PyEval_EvalFrameDefault. + + Initially, before any evaluation begins, it points to the + initial PyThreadState object's ``root_cframe`` object, which is + statically allocated for the lifetime of the thread. + + A greenlet can last for longer than a call to + PyEval_EvalFrameDefault, so we can't set its ``cframe`` pointer + to be the current ``PyThreadState->cframe``; nor could we use + one from the greenlet parent for the same reason. Yet a further + no: we can't allocate one scoped to the greenlet and then + destroy it when the greenlet is deallocated, because inside the + interpreter the _PyCFrame objects form a linked list, and that too + can result in accessing memory beyond its dynamic lifetime (if + the greenlet doesn't actually finish before it dies, its entry + could still be in the list). + + Using the ``root_cframe`` is problematic, though, because its + members are never modified by the interpreter and are set to 0, + meaning that its ``use_tracing`` flag is never updated. We don't + want to modify that value in the ``root_cframe`` ourself: it + *shouldn't* matter much because we should probably never get + back to the point where that's the only cframe on the stack; + even if it did matter, the major consequence of an incorrect + value for ``use_tracing`` is that if its true the interpreter + does some extra work --- however, it's just good code hygiene. + + Our solution: before a greenlet runs, after its initial + creation, it uses the ``root_cframe`` just to have something to + put there. However, once the greenlet is actually switched to + for the first time, ``g_initialstub`` (which doesn't actually + "return" while the greenlet is running) stores a new _PyCFrame on + its local stack, and copies the appropriate values from the + currently running _PyCFrame; this is then made the _PyCFrame for the + newly-minted greenlet. ``g_initialstub`` then proceeds to call + ``glet.run()``, which results in ``PyEval_...`` adding the + _PyCFrame to the list. Switches continue as normal. Finally, when + the greenlet finishes, the call to ``glet.run()`` returns and + the _PyCFrame is taken out of the linked list and the stack value + is now unused and free to expire. + + XXX: I think we can do better. If we're deallocing in the same + thread, can't we traverse the list and unlink our frame? + Can we just keep a reference to the thread state in case we + dealloc in another thread? (Is that even possible if we're still + running and haven't returned from g_initialstub?) + */ + this->cframe = &PyThreadState_GET()->root_cframe; +#endif +} + + +inline void PythonState::may_switch_away() noexcept +{ +#if GREENLET_PY311 + // PyThreadState_GetFrame is probably going to have to allocate a + // new frame object. That may trigger garbage collection. Because + // we call this during the early phases of a switch (it doesn't + // matter to which greenlet, as this has a global effect), if a GC + // triggers a switch away, two things can happen, both bad: + // - We might not get switched back to, halting forward progress. + // this is pathological, but possible. + // - We might get switched back to with a different set of + // arguments or a throw instead of a switch. That would corrupt + // our state (specifically, PyErr_Occurred() and this->args() + // would no longer agree). + // + // Thus, when we call this API, we need to have GC disabled. + // This method serves as a bottleneck we call when maybe beginning + // a switch. In this way, it is always safe -- no risk of GC -- to + // use ``_GetFrame()`` whenever we need to, just as it was in + // <=3.10 (because subsequent calls will be cached and not + // allocate memory). + + GCDisabledGuard no_gc; + Py_XDECREF(PyThreadState_GetFrame(PyThreadState_GET())); +#endif +} + +void PythonState::operator<<(const PyThreadState *const tstate) noexcept +{ + this->_context.steal(tstate->context); +#if GREENLET_USE_CFRAME + /* + IMPORTANT: ``cframe`` is a pointer into the STACK. Thus, because + the call to ``slp_switch()`` changes the contents of the stack, + you cannot read from ``ts_current->cframe`` after that call and + necessarily get the same values you get from reading it here. + Anything you need to restore from now to then must be saved in a + global/threadlocal variable (because we can't use stack + variables here either). For things that need to persist across + the switch, use `will_switch_from`. + */ + this->cframe = tstate->cframe; + #if !GREENLET_PY312 + this->use_tracing = tstate->cframe->use_tracing; + #endif +#endif // GREENLET_USE_CFRAME +#if GREENLET_PY311 + #if GREENLET_PY312 + this->py_recursion_depth = tstate->py_recursion_limit - tstate->py_recursion_remaining; + this->c_recursion_depth = Py_C_RECURSION_LIMIT - tstate->c_recursion_remaining; + #else // not 312 + this->recursion_depth = tstate->recursion_limit - tstate->recursion_remaining; + #endif // GREENLET_PY312 + #if GREENLET_PY313 + this->current_frame = tstate->current_frame; + #elif GREENLET_USE_CFRAME + this->current_frame = tstate->cframe->current_frame; + #endif + this->datastack_chunk = tstate->datastack_chunk; + this->datastack_top = tstate->datastack_top; + this->datastack_limit = tstate->datastack_limit; + + PyFrameObject *frame = PyThreadState_GetFrame((PyThreadState *)tstate); + Py_XDECREF(frame); // PyThreadState_GetFrame gives us a new + // reference. + this->_top_frame.steal(frame); + #if GREENLET_PY313 + this->delete_later = Py_XNewRef(tstate->delete_later); + #elif GREENLET_PY312 + this->trash_delete_nesting = tstate->trash.delete_nesting; + #else // not 312 + this->trash_delete_nesting = tstate->trash_delete_nesting; + #endif // GREENLET_PY312 +#else // Not 311 + this->recursion_depth = tstate->recursion_depth; + this->_top_frame.steal(tstate->frame); + this->trash_delete_nesting = tstate->trash_delete_nesting; +#endif // GREENLET_PY311 +} + +#if GREENLET_PY312 +void GREENLET_NOINLINE(PythonState::unexpose_frames)() +{ + if (!this->top_frame()) { + return; + } + + // See GreenletState::expose_frames() and the comment on frames_were_exposed + // for more information about this logic. + _PyInterpreterFrame *iframe = this->_top_frame->f_frame; + while (iframe != nullptr) { + _PyInterpreterFrame *prev_exposed = iframe->previous; + assert(iframe->frame_obj); + memcpy(&iframe->previous, &iframe->frame_obj->_f_frame_data[0], + sizeof(void *)); + iframe = prev_exposed; + } +} +#else +void PythonState::unexpose_frames() +{} +#endif + +void PythonState::operator>>(PyThreadState *const tstate) noexcept +{ + tstate->context = this->_context.relinquish_ownership(); + /* Incrementing this value invalidates the contextvars cache, + which would otherwise remain valid across switches */ + tstate->context_ver++; +#if GREENLET_USE_CFRAME + tstate->cframe = this->cframe; + /* + If we were tracing, we need to keep tracing. + There should never be the possibility of hitting the + root_cframe here. See note above about why we can't + just copy this from ``origin->cframe->use_tracing``. + */ + #if !GREENLET_PY312 + tstate->cframe->use_tracing = this->use_tracing; + #endif +#endif // GREENLET_USE_CFRAME +#if GREENLET_PY311 + #if GREENLET_PY312 + tstate->py_recursion_remaining = tstate->py_recursion_limit - this->py_recursion_depth; + tstate->c_recursion_remaining = Py_C_RECURSION_LIMIT - this->c_recursion_depth; + this->unexpose_frames(); + #else // \/ 3.11 + tstate->recursion_remaining = tstate->recursion_limit - this->recursion_depth; + #endif // GREENLET_PY312 + #if GREENLET_PY313 + tstate->current_frame = this->current_frame; + #elif GREENLET_USE_CFRAME + tstate->cframe->current_frame = this->current_frame; + #endif + tstate->datastack_chunk = this->datastack_chunk; + tstate->datastack_top = this->datastack_top; + tstate->datastack_limit = this->datastack_limit; + this->_top_frame.relinquish_ownership(); + #if GREENLET_PY313 + Py_XDECREF(tstate->delete_later); + tstate->delete_later = this->delete_later; + Py_CLEAR(this->delete_later); + #elif GREENLET_PY312 + tstate->trash.delete_nesting = this->trash_delete_nesting; + #else // not 3.12 + tstate->trash_delete_nesting = this->trash_delete_nesting; + #endif // GREENLET_PY312 +#else // not 3.11 + tstate->frame = this->_top_frame.relinquish_ownership(); + tstate->recursion_depth = this->recursion_depth; + tstate->trash_delete_nesting = this->trash_delete_nesting; +#endif // GREENLET_PY311 +} + +inline void PythonState::will_switch_from(PyThreadState *const origin_tstate) noexcept +{ +#if GREENLET_USE_CFRAME && !GREENLET_PY312 + // The weird thing is, we don't actually save this for an + // effect on the current greenlet, it's saved for an + // effect on the target greenlet. That is, we want + // continuity of this setting across the greenlet switch. + this->use_tracing = origin_tstate->cframe->use_tracing; +#endif +} + +void PythonState::set_initial_state(const PyThreadState* const tstate) noexcept +{ + this->_top_frame = nullptr; +#if GREENLET_PY312 + this->py_recursion_depth = tstate->py_recursion_limit - tstate->py_recursion_remaining; + // XXX: TODO: Comment from a reviewer: + // Should this be ``Py_C_RECURSION_LIMIT - tstate->c_recursion_remaining``? + // But to me it looks more like that might not be the right + // initialization either? + this->c_recursion_depth = tstate->py_recursion_limit - tstate->py_recursion_remaining; +#elif GREENLET_PY311 + this->recursion_depth = tstate->recursion_limit - tstate->recursion_remaining; +#else + this->recursion_depth = tstate->recursion_depth; +#endif +} +// TODO: Better state management about when we own the top frame. +int PythonState::tp_traverse(visitproc visit, void* arg, bool own_top_frame) noexcept +{ + Py_VISIT(this->_context.borrow()); + if (own_top_frame) { + Py_VISIT(this->_top_frame.borrow()); + } + return 0; +} + +void PythonState::tp_clear(bool own_top_frame) noexcept +{ + PythonStateContext::tp_clear(); + // If we get here owning a frame, + // we got dealloc'd without being finished. We may or may not be + // in the same thread. + if (own_top_frame) { + this->_top_frame.CLEAR(); + } +} + +#if GREENLET_USE_CFRAME +void PythonState::set_new_cframe(_PyCFrame& frame) noexcept +{ + frame = *PyThreadState_GET()->cframe; + /* Make the target greenlet refer to the stack value. */ + this->cframe = &frame; + /* + And restore the link to the previous frame so this one gets + unliked appropriately. + */ + this->cframe->previous = &PyThreadState_GET()->root_cframe; +} +#endif + +const PythonState::OwnedFrame& PythonState::top_frame() const noexcept +{ + return this->_top_frame; +} + +void PythonState::did_finish(PyThreadState* tstate) noexcept +{ +#if GREENLET_PY311 + // See https://github.com/gevent/gevent/issues/1924 and + // https://github.com/python-greenlet/greenlet/issues/328. In + // short, Python 3.11 allocates memory for frames as a sort of + // linked list that's kept as part of PyThreadState in the + // ``datastack_chunk`` member and friends. These are saved and + // restored as part of switching greenlets. + // + // When we initially switch to a greenlet, we set those to NULL. + // That causes the frame management code to treat this like a + // brand new thread and start a fresh list of chunks, beginning + // with a new "root" chunk. As we make calls in this greenlet, + // those chunks get added, and as calls return, they get popped. + // But the frame code (pystate.c) is careful to make sure that the + // root chunk never gets popped. + // + // Thus, when a greenlet exits for the last time, there will be at + // least a single root chunk that we must be responsible for + // deallocating. + // + // The complex part is that these chunks are allocated and freed + // using ``_PyObject_VirtualAlloc``/``Free``. Those aren't public + // functions, and they aren't exported for linking. It so happens + // that we know they are just thin wrappers around the Arena + // allocator, so we can use that directly to deallocate in a + // compatible way. + // + // CAUTION: Check this implementation detail on every major version. + // + // It might be nice to be able to do this in our destructor, but + // can we be sure that no one else is using that memory? Plus, as + // described below, our pointers may not even be valid anymore. As + // a special case, there is one time that we know we can do this, + // and that's from the destructor of the associated UserGreenlet + // (NOT main greenlet) + PyObjectArenaAllocator alloc; + _PyStackChunk* chunk = nullptr; + if (tstate) { + // We really did finish, we can never be switched to again. + chunk = tstate->datastack_chunk; + // Unfortunately, we can't do much sanity checking. Our + // this->datastack_chunk pointer is out of date (evaluation may + // have popped down through it already) so we can't verify that + // we deallocate it. I don't think we can even check datastack_top + // for the same reason. + + PyObject_GetArenaAllocator(&alloc); + tstate->datastack_chunk = nullptr; + tstate->datastack_limit = nullptr; + tstate->datastack_top = nullptr; + + } + else if (this->datastack_chunk) { + // The UserGreenlet (NOT the main greenlet!) is being deallocated. If we're + // still holding a stack chunk, it's garbage because we know + // we can never switch back to let cPython clean it up. + // Because the last time we got switched away from, and we + // haven't run since then, we know our chain is valid and can + // be dealloced. + chunk = this->datastack_chunk; + PyObject_GetArenaAllocator(&alloc); + } + + if (alloc.free && chunk) { + // In case the arena mechanism has been torn down already. + while (chunk) { + _PyStackChunk *prev = chunk->previous; + chunk->previous = nullptr; + alloc.free(alloc.ctx, chunk, chunk->size); + chunk = prev; + } + } + + this->datastack_chunk = nullptr; + this->datastack_limit = nullptr; + this->datastack_top = nullptr; +#endif +} + + +}; // namespace greenlet + +#endif // GREENLET_PYTHON_STATE_CPP diff --git a/.venv/Lib/site-packages/greenlet/TStackState.cpp b/.venv/Lib/site-packages/greenlet/TStackState.cpp new file mode 100644 index 0000000..9743ab5 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TStackState.cpp @@ -0,0 +1,265 @@ +#ifndef GREENLET_STACK_STATE_CPP +#define GREENLET_STACK_STATE_CPP + +#include "TGreenlet.hpp" + +namespace greenlet { + +#ifdef GREENLET_USE_STDIO +#include +using std::cerr; +using std::endl; + +std::ostream& operator<<(std::ostream& os, const StackState& s) +{ + os << "StackState(stack_start=" << (void*)s._stack_start + << ", stack_stop=" << (void*)s.stack_stop + << ", stack_copy=" << (void*)s.stack_copy + << ", stack_saved=" << s._stack_saved + << ", stack_prev=" << s.stack_prev + << ", addr=" << &s + << ")"; + return os; +} +#endif + +StackState::StackState(void* mark, StackState& current) + : _stack_start(nullptr), + stack_stop((char*)mark), + stack_copy(nullptr), + _stack_saved(0), + /* Skip a dying greenlet */ + stack_prev(current._stack_start + ? ¤t + : current.stack_prev) +{ +} + +StackState::StackState() + : _stack_start(nullptr), + stack_stop(nullptr), + stack_copy(nullptr), + _stack_saved(0), + stack_prev(nullptr) +{ +} + +StackState::StackState(const StackState& other) +// can't use a delegating constructor because of +// MSVC for Python 2.7 + : _stack_start(nullptr), + stack_stop(nullptr), + stack_copy(nullptr), + _stack_saved(0), + stack_prev(nullptr) +{ + this->operator=(other); +} + +StackState& StackState::operator=(const StackState& other) +{ + if (&other == this) { + return *this; + } + if (other._stack_saved) { + throw std::runtime_error("Refusing to steal memory."); + } + + //If we have memory allocated, dispose of it + this->free_stack_copy(); + + this->_stack_start = other._stack_start; + this->stack_stop = other.stack_stop; + this->stack_copy = other.stack_copy; + this->_stack_saved = other._stack_saved; + this->stack_prev = other.stack_prev; + return *this; +} + +inline void StackState::free_stack_copy() noexcept +{ + PyMem_Free(this->stack_copy); + this->stack_copy = nullptr; + this->_stack_saved = 0; +} + +inline void StackState::copy_heap_to_stack(const StackState& current) noexcept +{ + + /* Restore the heap copy back into the C stack */ + if (this->_stack_saved != 0) { + memcpy(this->_stack_start, this->stack_copy, this->_stack_saved); + this->free_stack_copy(); + } + StackState* owner = const_cast(¤t); + if (!owner->_stack_start) { + owner = owner->stack_prev; /* greenlet is dying, skip it */ + } + while (owner && owner->stack_stop <= this->stack_stop) { + // cerr << "\tOwner: " << owner << endl; + owner = owner->stack_prev; /* find greenlet with more stack */ + } + this->stack_prev = owner; + // cerr << "\tFinished with: " << *this << endl; +} + +inline int StackState::copy_stack_to_heap_up_to(const char* const stop) noexcept +{ + /* Save more of g's stack into the heap -- at least up to 'stop' + g->stack_stop |________| + | | + | __ stop . . . . . + | | ==> . . + |________| _______ + | | | | + | | | | + g->stack_start | | |_______| g->stack_copy + */ + intptr_t sz1 = this->_stack_saved; + intptr_t sz2 = stop - this->_stack_start; + assert(this->_stack_start); + if (sz2 > sz1) { + char* c = (char*)PyMem_Realloc(this->stack_copy, sz2); + if (!c) { + PyErr_NoMemory(); + return -1; + } + memcpy(c + sz1, this->_stack_start + sz1, sz2 - sz1); + this->stack_copy = c; + this->_stack_saved = sz2; + } + return 0; +} + +inline int StackState::copy_stack_to_heap(char* const stackref, + const StackState& current) noexcept +{ + /* must free all the C stack up to target_stop */ + const char* const target_stop = this->stack_stop; + + StackState* owner = const_cast(¤t); + assert(owner->_stack_saved == 0); // everything is present on the stack + if (!owner->_stack_start) { + owner = owner->stack_prev; /* not saved if dying */ + } + else { + owner->_stack_start = stackref; + } + + while (owner->stack_stop < target_stop) { + /* ts_current is entierely within the area to free */ + if (owner->copy_stack_to_heap_up_to(owner->stack_stop)) { + return -1; /* XXX */ + } + owner = owner->stack_prev; + } + if (owner != this) { + if (owner->copy_stack_to_heap_up_to(target_stop)) { + return -1; /* XXX */ + } + } + return 0; +} + +inline bool StackState::started() const noexcept +{ + return this->stack_stop != nullptr; +} + +inline bool StackState::main() const noexcept +{ + return this->stack_stop == (char*)-1; +} + +inline bool StackState::active() const noexcept +{ + return this->_stack_start != nullptr; +} + +inline void StackState::set_active() noexcept +{ + assert(this->_stack_start == nullptr); + this->_stack_start = (char*)1; +} + +inline void StackState::set_inactive() noexcept +{ + this->_stack_start = nullptr; + // XXX: What if we still have memory out there? + // That case is actually triggered by + // test_issue251_issue252_explicit_reference_not_collectable (greenlet.tests.test_leaks.TestLeaks) + // and + // test_issue251_issue252_need_to_collect_in_background + // (greenlet.tests.test_leaks.TestLeaks) + // + // Those objects never get deallocated, so the destructor never + // runs. + // It *seems* safe to clean up the memory here? + if (this->_stack_saved) { + this->free_stack_copy(); + } +} + +inline intptr_t StackState::stack_saved() const noexcept +{ + return this->_stack_saved; +} + +inline char* StackState::stack_start() const noexcept +{ + return this->_stack_start; +} + + +inline StackState StackState::make_main() noexcept +{ + StackState s; + s._stack_start = (char*)1; + s.stack_stop = (char*)-1; + return s; +} + +StackState::~StackState() +{ + if (this->_stack_saved != 0) { + this->free_stack_copy(); + } +} + +void StackState::copy_from_stack(void* vdest, const void* vsrc, size_t n) const +{ + char* dest = static_cast(vdest); + const char* src = static_cast(vsrc); + if (src + n <= this->_stack_start + || src >= this->_stack_start + this->_stack_saved + || this->_stack_saved == 0) { + // Nothing we're copying was spilled from the stack + memcpy(dest, src, n); + return; + } + + if (src < this->_stack_start) { + // Copy the part before the saved stack. + // We know src + n > _stack_start due to the test above. + const size_t nbefore = this->_stack_start - src; + memcpy(dest, src, nbefore); + dest += nbefore; + src += nbefore; + n -= nbefore; + } + // We know src >= _stack_start after the before-copy, and + // src < _stack_start + _stack_saved due to the first if condition + size_t nspilled = std::min(n, this->_stack_start + this->_stack_saved - src); + memcpy(dest, this->stack_copy + (src - this->_stack_start), nspilled); + dest += nspilled; + src += nspilled; + n -= nspilled; + if (n > 0) { + // Copy the part after the saved stack + memcpy(dest, src, n); + } +} + +}; // namespace greenlet + +#endif // GREENLET_STACK_STATE_CPP diff --git a/.venv/Lib/site-packages/greenlet/TThreadState.hpp b/.venv/Lib/site-packages/greenlet/TThreadState.hpp new file mode 100644 index 0000000..e4e6f6c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TThreadState.hpp @@ -0,0 +1,497 @@ +#ifndef GREENLET_THREAD_STATE_HPP +#define GREENLET_THREAD_STATE_HPP + +#include +#include + +#include "greenlet_internal.hpp" +#include "greenlet_refs.hpp" +#include "greenlet_thread_support.hpp" + +using greenlet::refs::BorrowedObject; +using greenlet::refs::BorrowedGreenlet; +using greenlet::refs::BorrowedMainGreenlet; +using greenlet::refs::OwnedMainGreenlet; +using greenlet::refs::OwnedObject; +using greenlet::refs::OwnedGreenlet; +using greenlet::refs::OwnedList; +using greenlet::refs::PyErrFetchParam; +using greenlet::refs::PyArgParseParam; +using greenlet::refs::ImmortalString; +using greenlet::refs::CreatedModule; +using greenlet::refs::PyErrPieces; +using greenlet::refs::NewReference; + +namespace greenlet { +/** + * Thread-local state of greenlets. + * + * Each native thread will get exactly one of these objects, + * automatically accessed through the best available thread-local + * mechanism the compiler supports (``thread_local`` for C++11 + * compilers or ``__thread``/``declspec(thread)`` for older GCC/clang + * or MSVC, respectively.) + * + * Previously, we kept thread-local state mostly in a bunch of + * ``static volatile`` variables in the main greenlet file.. This had + * the problem of requiring extra checks, loops, and great care + * accessing these variables if we potentially invoked any Python code + * that could release the GIL, because the state could change out from + * under us. Making the variables thread-local solves this problem. + * + * When we detected that a greenlet API accessing the current greenlet + * was invoked from a different thread than the greenlet belonged to, + * we stored a reference to the greenlet in the Python thread + * dictionary for the thread the greenlet belonged to. This could lead + * to memory leaks if the thread then exited (because of a reference + * cycle, as greenlets referred to the thread dictionary, and deleting + * non-current greenlets leaked their frame plus perhaps arguments on + * the C stack). If a thread exited while still having running + * greenlet objects (perhaps that had just switched back to the main + * greenlet), and did not invoke one of the greenlet APIs *in that + * thread, immediately before it exited, without some other thread + * then being invoked*, such a leak was guaranteed. + * + * This can be partly solved by using compiler thread-local variables + * instead of the Python thread dictionary, thus avoiding a cycle. + * + * To fully solve this problem, we need a reliable way to know that a + * thread is done and we should clean up the main greenlet. On POSIX, + * we can use the destructor function of ``pthread_key_create``, but + * there's nothing similar on Windows; a C++11 thread local object + * reliably invokes its destructor when the thread it belongs to exits + * (non-C++11 compilers offer ``__thread`` or ``declspec(thread)`` to + * create thread-local variables, but they can't hold C++ objects that + * invoke destructors; the C++11 version is the most portable solution + * I found). When the thread exits, we can drop references and + * otherwise manipulate greenlets and frames that we know can no + * longer be switched to. For compilers that don't support C++11 + * thread locals, we have a solution that uses the python thread + * dictionary, though it may not collect everything as promptly as + * other compilers do, if some other library is using the thread + * dictionary and has a cycle or extra reference. + * + * There are two small wrinkles. The first is that when the thread + * exits, it is too late to actually invoke Python APIs: the Python + * thread state is gone, and the GIL is released. To solve *this* + * problem, our destructor uses ``Py_AddPendingCall`` to transfer the + * destruction work to the main thread. (This is not an issue for the + * dictionary solution.) + * + * The second is that once the thread exits, the thread local object + * is invalid and we can't even access a pointer to it, so we can't + * pass it to ``Py_AddPendingCall``. This is handled by actually using + * a second object that's thread local (ThreadStateCreator) and having + * it dynamically allocate this object so it can live until the + * pending call runs. + */ + + + +class ThreadState { +private: + // As of commit 08ad1dd7012b101db953f492e0021fb08634afad + // this class needed 56 bytes in o Py_DEBUG build + // on 64-bit macOS 11. + // Adding the vector takes us up to 80 bytes () + + /* Strong reference to the main greenlet */ + OwnedMainGreenlet main_greenlet; + + /* Strong reference to the current greenlet. */ + OwnedGreenlet current_greenlet; + + /* Strong reference to the trace function, if any. */ + OwnedObject tracefunc; + + typedef std::vector > deleteme_t; + /* A vector of raw PyGreenlet pointers representing things that need + deleted when this thread is running. The vector owns the + references, but you need to manually INCREF/DECREF as you use + them. We don't use a vector because we + make copy of this vector, and that would become O(n) as all the + refcounts are incremented in the copy. + */ + deleteme_t deleteme; + +#ifdef GREENLET_NEEDS_EXCEPTION_STATE_SAVED + void* exception_state; +#endif + + static std::clock_t _clocks_used_doing_gc; + static ImmortalString get_referrers_name; + static PythonAllocator allocator; + + G_NO_COPIES_OF_CLS(ThreadState); + + + // Allocates a main greenlet for the thread state. If this fails, + // exits the process. Called only during constructing a ThreadState. + MainGreenlet* alloc_main() + { + PyGreenlet* gmain; + + /* create the main greenlet for this thread */ + gmain = reinterpret_cast(PyType_GenericAlloc(&PyGreenlet_Type, 0)); + if (gmain == NULL) { + throw PyFatalError("alloc_main failed to alloc"); //exits the process + } + + MainGreenlet* const main = new MainGreenlet(gmain, this); + + assert(Py_REFCNT(gmain) == 1); + assert(gmain->pimpl == main); + return main; + } + + +public: + static void* operator new(size_t UNUSED(count)) + { + return ThreadState::allocator.allocate(1); + } + + static void operator delete(void* ptr) + { + return ThreadState::allocator.deallocate(static_cast(ptr), + 1); + } + + static void init() + { + ThreadState::get_referrers_name = "get_referrers"; + ThreadState::_clocks_used_doing_gc = 0; + } + + ThreadState() + { + +#ifdef GREENLET_NEEDS_EXCEPTION_STATE_SAVED + this->exception_state = slp_get_exception_state(); +#endif + + // XXX: Potentially dangerous, exposing a not fully + // constructed object. + MainGreenlet* const main = this->alloc_main(); + this->main_greenlet = OwnedMainGreenlet::consuming( + main->self() + ); + assert(this->main_greenlet); + this->current_greenlet = main->self(); + // The main greenlet starts with 1 refs: The returned one. We + // then copied it to the current greenlet. + assert(this->main_greenlet.REFCNT() == 2); + } + + inline void restore_exception_state() + { +#ifdef GREENLET_NEEDS_EXCEPTION_STATE_SAVED + // It's probably important this be inlined and only call C + // functions to avoid adding an SEH frame. + slp_set_exception_state(this->exception_state); +#endif + } + + inline bool has_main_greenlet() const noexcept + { + return bool(this->main_greenlet); + } + + // Called from the ThreadStateCreator when we're in non-standard + // threading mode. In that case, there is an object in the Python + // thread state dictionary that points to us. The main greenlet + // also traverses into us, in which case it's crucial not to + // traverse back into the main greenlet. + int tp_traverse(visitproc visit, void* arg, bool traverse_main=true) + { + if (traverse_main) { + Py_VISIT(main_greenlet.borrow_o()); + } + if (traverse_main || current_greenlet != main_greenlet) { + Py_VISIT(current_greenlet.borrow_o()); + } + Py_VISIT(tracefunc.borrow()); + return 0; + } + + inline BorrowedMainGreenlet borrow_main_greenlet() const noexcept + { + assert(this->main_greenlet); + assert(this->main_greenlet.REFCNT() >= 2); + return this->main_greenlet; + }; + + inline OwnedMainGreenlet get_main_greenlet() const noexcept + { + return this->main_greenlet; + } + + /** + * In addition to returning a new reference to the currunt + * greenlet, this performs any maintenance needed. + */ + inline OwnedGreenlet get_current() + { + /* green_dealloc() cannot delete greenlets from other threads, so + it stores them in the thread dict; delete them now. */ + this->clear_deleteme_list(); + //assert(this->current_greenlet->main_greenlet == this->main_greenlet); + //assert(this->main_greenlet->main_greenlet == this->main_greenlet); + return this->current_greenlet; + } + + /** + * As for non-const get_current(); + */ + inline BorrowedGreenlet borrow_current() + { + this->clear_deleteme_list(); + return this->current_greenlet; + } + + /** + * Does no maintenance. + */ + inline OwnedGreenlet get_current() const + { + return this->current_greenlet; + } + + template + inline bool is_current(const refs::PyObjectPointer& obj) const + { + return this->current_greenlet.borrow_o() == obj.borrow_o(); + } + + inline void set_current(const OwnedGreenlet& target) + { + this->current_greenlet = target; + } + +private: + /** + * Deref and remove the greenlets from the deleteme list. Must be + * holding the GIL. + * + * If *murder* is true, then we must be called from a different + * thread than the one that these greenlets were running in. + * In that case, if the greenlet was actually running, we destroy + * the frame reference and otherwise make it appear dead before + * proceeding; otherwise, we would try (and fail) to raise an + * exception in it and wind up right back in this list. + */ + inline void clear_deleteme_list(const bool murder=false) + { + if (!this->deleteme.empty()) { + // It's possible we could add items to this list while + // running Python code if there's a thread switch, so we + // need to defensively copy it before that can happen. + deleteme_t copy = this->deleteme; + this->deleteme.clear(); // in case things come back on the list + for(deleteme_t::iterator it = copy.begin(), end = copy.end(); + it != end; + ++it ) { + PyGreenlet* to_del = *it; + if (murder) { + // Force each greenlet to appear dead; we can't raise an + // exception into it anymore anyway. + to_del->pimpl->murder_in_place(); + } + + // The only reference to these greenlets should be in + // this list, decreffing them should let them be + // deleted again, triggering calls to green_dealloc() + // in the correct thread (if we're not murdering). + // This may run arbitrary Python code and switch + // threads or greenlets! + Py_DECREF(to_del); + if (PyErr_Occurred()) { + PyErr_WriteUnraisable(nullptr); + PyErr_Clear(); + } + } + } + } + +public: + + /** + * Returns a new reference, or a false object. + */ + inline OwnedObject get_tracefunc() const + { + return tracefunc; + }; + + + inline void set_tracefunc(BorrowedObject tracefunc) + { + assert(tracefunc); + if (tracefunc == BorrowedObject(Py_None)) { + this->tracefunc.CLEAR(); + } + else { + this->tracefunc = tracefunc; + } + } + + /** + * Given a reference to a greenlet that some other thread + * attempted to delete (has a refcount of 0) store it for later + * deletion when the thread this state belongs to is current. + */ + inline void delete_when_thread_running(PyGreenlet* to_del) + { + Py_INCREF(to_del); + this->deleteme.push_back(to_del); + } + + /** + * Set to std::clock_t(-1) to disable. + */ + inline static std::clock_t& clocks_used_doing_gc() + { + return ThreadState::_clocks_used_doing_gc; + } + + ~ThreadState() + { + if (!PyInterpreterState_Head()) { + // We shouldn't get here (our callers protect us) + // but if we do, all we can do is bail early. + return; + } + + // We should not have an "origin" greenlet; that only exists + // for the temporary time during a switch, which should not + // be in progress as the thread dies. + //assert(!this->switching_state.origin); + + this->tracefunc.CLEAR(); + + // Forcibly GC as much as we can. + this->clear_deleteme_list(true); + + // The pending call did this. + assert(this->main_greenlet->thread_state() == nullptr); + + // If the main greenlet is the current greenlet, + // then we "fell off the end" and the thread died. + // It's possible that there is some other greenlet that + // switched to us, leaving a reference to the main greenlet + // on the stack, somewhere uncollectible. Try to detect that. + if (this->current_greenlet == this->main_greenlet && this->current_greenlet) { + assert(this->current_greenlet->is_currently_running_in_some_thread()); + // Drop one reference we hold. + this->current_greenlet.CLEAR(); + assert(!this->current_greenlet); + // Only our reference to the main greenlet should be left, + // But hold onto the pointer in case we need to do extra cleanup. + PyGreenlet* old_main_greenlet = this->main_greenlet.borrow(); + Py_ssize_t cnt = this->main_greenlet.REFCNT(); + this->main_greenlet.CLEAR(); + if (ThreadState::_clocks_used_doing_gc != std::clock_t(-1) + && cnt == 2 && Py_REFCNT(old_main_greenlet) == 1) { + // Highly likely that the reference is somewhere on + // the stack, not reachable by GC. Verify. + // XXX: This is O(n) in the total number of objects. + // TODO: Add a way to disable this at runtime, and + // another way to report on it. + std::clock_t begin = std::clock(); + NewReference gc(PyImport_ImportModule("gc")); + if (gc) { + OwnedObject get_referrers = gc.PyRequireAttr(ThreadState::get_referrers_name); + OwnedList refs(get_referrers.PyCall(old_main_greenlet)); + if (refs && refs.empty()) { + assert(refs.REFCNT() == 1); + // We found nothing! So we left a dangling + // reference: Probably the last thing some + // other greenlet did was call + // 'getcurrent().parent.switch()' to switch + // back to us. Clean it up. This will be the + // case on CPython 3.7 and newer, as they use + // an internal calling conversion that avoids + // creating method objects and storing them on + // the stack. + Py_DECREF(old_main_greenlet); + } + else if (refs + && refs.size() == 1 + && PyCFunction_Check(refs.at(0)) + && Py_REFCNT(refs.at(0)) == 2) { + assert(refs.REFCNT() == 1); + // Ok, we found a C method that refers to the + // main greenlet, and its only referenced + // twice, once in the list we just created, + // once from...somewhere else. If we can't + // find where else, then this is a leak. + // This happens in older versions of CPython + // that create a bound method object somewhere + // on the stack that we'll never get back to. + if (PyCFunction_GetFunction(refs.at(0).borrow()) == (PyCFunction)green_switch) { + BorrowedObject function_w = refs.at(0); + refs.clear(); // destroy the reference + // from the list. + // back to one reference. Can *it* be + // found? + assert(function_w.REFCNT() == 1); + refs = get_referrers.PyCall(function_w); + if (refs && refs.empty()) { + // Nope, it can't be found so it won't + // ever be GC'd. Drop it. + Py_CLEAR(function_w); + } + } + } + std::clock_t end = std::clock(); + ThreadState::_clocks_used_doing_gc += (end - begin); + } + } + } + + // We need to make sure this greenlet appears to be dead, + // because otherwise deallocing it would fail to raise an + // exception in it (the thread is dead) and put it back in our + // deleteme list. + if (this->current_greenlet) { + this->current_greenlet->murder_in_place(); + this->current_greenlet.CLEAR(); + } + + if (this->main_greenlet) { + // Couldn't have been the main greenlet that was running + // when the thread exited (because we already cleared this + // pointer if it was). This shouldn't be possible? + + // If the main greenlet was current when the thread died (it + // should be, right?) then we cleared its self pointer above + // when we cleared the current greenlet's main greenlet pointer. + // assert(this->main_greenlet->main_greenlet == this->main_greenlet + // || !this->main_greenlet->main_greenlet); + // // self reference, probably gone + // this->main_greenlet->main_greenlet.CLEAR(); + + // This will actually go away when the ivar is destructed. + this->main_greenlet.CLEAR(); + } + + if (PyErr_Occurred()) { + PyErr_WriteUnraisable(NULL); + PyErr_Clear(); + } + + } + +}; + +ImmortalString ThreadState::get_referrers_name(nullptr); +PythonAllocator ThreadState::allocator; +std::clock_t ThreadState::_clocks_used_doing_gc(0); + + + + + +}; // namespace greenlet + +#endif diff --git a/.venv/Lib/site-packages/greenlet/TThreadStateCreator.hpp b/.venv/Lib/site-packages/greenlet/TThreadStateCreator.hpp new file mode 100644 index 0000000..2ec7ab5 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TThreadStateCreator.hpp @@ -0,0 +1,102 @@ +#ifndef GREENLET_THREAD_STATE_CREATOR_HPP +#define GREENLET_THREAD_STATE_CREATOR_HPP + +#include +#include + +#include "greenlet_internal.hpp" +#include "greenlet_refs.hpp" +#include "greenlet_thread_support.hpp" + +#include "TThreadState.hpp" + +namespace greenlet { + + +typedef void (*ThreadStateDestructor)(ThreadState* const); + +template +class ThreadStateCreator +{ +private: + // Initialized to 1, and, if still 1, created on access. + // Set to 0 on destruction. + ThreadState* _state; + G_NO_COPIES_OF_CLS(ThreadStateCreator); + + inline bool has_initialized_state() const noexcept + { + return this->_state != (ThreadState*)1; + } + + inline bool has_state() const noexcept + { + return this->has_initialized_state() && this->_state != nullptr; + } + +public: + + // Only one of these, auto created per thread. + // Constructing the state constructs the MainGreenlet. + ThreadStateCreator() : + _state((ThreadState*)1) + { + } + + ~ThreadStateCreator() + { + if (this->has_state()) { + Destructor(this->_state); + } + + this->_state = nullptr; + } + + inline ThreadState& state() + { + // The main greenlet will own this pointer when it is created, + // which will be right after this. The plan is to give every + // greenlet a pointer to the main greenlet for the thread it + // runs in; if we are doing something cross-thread, we need to + // access the pointer from the main greenlet. Deleting the + // thread, and hence the thread-local storage, will delete the + // state pointer in the main greenlet. + if (!this->has_initialized_state()) { + // XXX: Assuming allocation never fails + this->_state = new ThreadState; + // For non-standard threading, we need to store an object + // in the Python thread state dictionary so that it can be + // DECREF'd when the thread ends (ideally; the dict could + // last longer) and clean this object up. + } + if (!this->_state) { + throw std::runtime_error("Accessing state after destruction."); + } + return *this->_state; + } + + operator ThreadState&() + { + return this->state(); + } + + operator ThreadState*() + { + return &this->state(); + } + + inline int tp_traverse(visitproc visit, void* arg) + { + if (this->has_state()) { + return this->_state->tp_traverse(visit, arg); + } + return 0; + } + +}; + + + +}; // namespace greenlet + +#endif diff --git a/.venv/Lib/site-packages/greenlet/TThreadStateDestroy.cpp b/.venv/Lib/site-packages/greenlet/TThreadStateDestroy.cpp new file mode 100644 index 0000000..37fcc8c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TThreadStateDestroy.cpp @@ -0,0 +1,258 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + * Implementation of the ThreadState destructors. + * + * Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ +#ifndef T_THREADSTATE_DESTROY +#define T_THREADSTATE_DESTROY + +#include "TGreenlet.hpp" + +#include "greenlet_thread_support.hpp" +#include "greenlet_cpython_add_pending.hpp" +#include "greenlet_compiler_compat.hpp" +#include "TGreenletGlobals.cpp" +#include "TThreadState.hpp" +#include "TThreadStateCreator.hpp" + +namespace greenlet { + +extern "C" { + +struct ThreadState_DestroyNoGIL +{ + /** + This function uses the same lock that the PendingCallback does + */ + static void + MarkGreenletDeadAndQueueCleanup(ThreadState* const state) + { +#if GREENLET_BROKEN_THREAD_LOCAL_CLEANUP_JUST_LEAK + return; +#endif + // We are *NOT* holding the GIL. Our thread is in the middle + // of its death throes and the Python thread state is already + // gone so we can't use most Python APIs. One that is safe is + // ``Py_AddPendingCall``, unless the interpreter itself has + // been torn down. There is a limited number of calls that can + // be queued: 32 (NPENDINGCALLS) in CPython 3.10, so we + // coalesce these calls using our own queue. + + if (!MarkGreenletDeadIfNeeded(state)) { + // No state, or no greenlet + return; + } + + // XXX: Because we don't have the GIL, this is a race condition. + if (!PyInterpreterState_Head()) { + // We have to leak the thread state, if the + // interpreter has shut down when we're getting + // deallocated, we can't run the cleanup code that + // deleting it would imply. + return; + } + + AddToCleanupQueue(state); + + } + +private: + + // If the state has an allocated main greenlet: + // - mark the greenlet as dead by disassociating it from the state; + // - return 1 + // Otherwise, return 0. + static bool + MarkGreenletDeadIfNeeded(ThreadState* const state) + { + if (state && state->has_main_greenlet()) { + // mark the thread as dead ASAP. + // this is racy! If we try to throw or switch to a + // greenlet from this thread from some other thread before + // we clear the state pointer, it won't realize the state + // is dead which can crash the process. + PyGreenlet* p(state->borrow_main_greenlet().borrow()); + assert(p->pimpl->thread_state() == state || p->pimpl->thread_state() == nullptr); + dynamic_cast(p->pimpl)->thread_state(nullptr); + return true; + } + return false; + } + + static void + AddToCleanupQueue(ThreadState* const state) + { + assert(state && state->has_main_greenlet()); + + // NOTE: Because we're not holding the GIL here, some other + // Python thread could run and call ``os.fork()``, which would + // be bad if that happened while we are holding the cleanup + // lock (it wouldn't function in the child process). + // Make a best effort to try to keep the duration we hold the + // lock short. + // TODO: On platforms that support it, use ``pthread_atfork`` to + // drop this lock. + LockGuard cleanup_lock(*mod_globs->thread_states_to_destroy_lock); + + mod_globs->queue_to_destroy(state); + if (mod_globs->thread_states_to_destroy.size() == 1) { + // We added the first item to the queue. We need to schedule + // the cleanup. + + // A size greater than 1 means that we have already added the pending call, + // and in fact, it may be executing now. + // If it is executing, our lock makes sure that it will see the item we just added + // to the queue on its next iteration (after we release the lock) + // + // A size of 1 means there is no pending call, OR the pending call is + // currently executing, has dropped the lock, and is deleting the last item + // from the queue; its next iteration will go ahead and delete the item we just added. + // And the pending call we schedule here will have no work to do. + int result = AddPendingCall( + PendingCallback_DestroyQueueWithGIL, + nullptr); + if (result < 0) { + // Hmm, what can we do here? + fprintf(stderr, + "greenlet: WARNING: failed in call to Py_AddPendingCall; " + "expect a memory leak.\n"); + } + } + } + + static int + PendingCallback_DestroyQueueWithGIL(void* UNUSED(arg)) + { + // We're holding the GIL here, so no Python code should be able to + // run to call ``os.fork()``. + while (1) { + ThreadState* to_destroy; + { + LockGuard cleanup_lock(*mod_globs->thread_states_to_destroy_lock); + if (mod_globs->thread_states_to_destroy.empty()) { + break; + } + to_destroy = mod_globs->take_next_to_destroy(); + } + assert(to_destroy); + assert(to_destroy->has_main_greenlet()); + // Drop the lock while we do the actual deletion. + // This allows other calls to MarkGreenletDeadAndQueueCleanup + // to enter and add to our queue. + DestroyOneWithGIL(to_destroy); + } + return 0; + } + + static void + DestroyOneWithGIL(const ThreadState* const state) + { + // Holding the GIL. + // Passed a non-shared pointer to the actual thread state. + // state -> main greenlet + assert(state->has_main_greenlet()); + PyGreenlet* main(state->borrow_main_greenlet()); + // When we need to do cross-thread operations, we check this. + // A NULL value means the thread died some time ago. + // We do this here, rather than in a Python dealloc function + // for the greenlet, in case there's still a reference out + // there. + dynamic_cast(main->pimpl)->thread_state(nullptr); + + delete state; // Deleting this runs the destructor, DECREFs the main greenlet. + } + + // ensure this is actually defined. + static_assert(GREENLET_BROKEN_PY_ADD_PENDING == 1 || GREENLET_BROKEN_PY_ADD_PENDING == 0, + "GREENLET_BROKEN_PY_ADD_PENDING not defined correctly."); + +#if GREENLET_BROKEN_PY_ADD_PENDING + static int _push_pending_call(struct _pending_calls *pending, + int (*func)(void *), void *arg) + { + int i = pending->last; + int j = (i + 1) % NPENDINGCALLS; + if (j == pending->first) { + return -1; /* Queue full */ + } + pending->calls[i].func = func; + pending->calls[i].arg = arg; + pending->last = j; + return 0; + } + + static int AddPendingCall(int (*func)(void *), void *arg) + { + _PyRuntimeState *runtime = &_PyRuntime; + if (!runtime) { + // obviously impossible + return 0; + } + struct _pending_calls *pending = &runtime->ceval.pending; + if (!pending->lock) { + return 0; + } + int result = 0; + PyThread_acquire_lock(pending->lock, WAIT_LOCK); + if (!pending->finishing) { + result = _push_pending_call(pending, func, arg); + } + PyThread_release_lock(pending->lock); + SIGNAL_PENDING_CALLS(&runtime->ceval); + return result; + } +#else + // Python < 3.8 or >= 3.9 + static int AddPendingCall(int (*func)(void*), void* arg) + { + // If the interpreter is in the middle of finalizing, we can't add a + // pending call. Trying to do so will end up in a SIGSEGV, as + // Py_AddPendingCall will not be able to get the interpreter and will + // try to dereference a NULL pointer. It's possible this can still + // segfault if we happen to get context switched, and maybe we should + // just always implement our own AddPendingCall, but I'd like to see if + // this works first +#if GREENLET_PY313 + if (Py_IsFinalizing()) { +#else + if (_Py_IsFinalizing()) { +#endif +#ifdef GREENLET_DEBUG + // No need to log in the general case. Yes, we'll leak, + // but we're shutting down so it should be ok. + fprintf(stderr, + "greenlet: WARNING: Interpreter is finalizing. Ignoring " + "call to Py_AddPendingCall; \n"); +#endif + return 0; + } + return Py_AddPendingCall(func, arg); + } +#endif + + + + +}; +}; + +}; // namespace greenlet + +// The intent when GET_THREAD_STATE() is needed multiple times in a +// function is to take a reference to its return value in a local +// variable, to avoid the thread-local indirection. On some platforms +// (macOS), accessing a thread-local involves a function call (plus an +// initial function call in each function that uses a thread local); +// in contrast, static volatile variables are at some pre-computed +// offset. +typedef greenlet::ThreadStateCreator ThreadStateCreator; +static thread_local ThreadStateCreator g_thread_state_global; +#define GET_THREAD_STATE() g_thread_state_global + +#endif //T_THREADSTATE_DESTROY diff --git a/.venv/Lib/site-packages/greenlet/TUserGreenlet.cpp b/.venv/Lib/site-packages/greenlet/TUserGreenlet.cpp new file mode 100644 index 0000000..73a8133 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/TUserGreenlet.cpp @@ -0,0 +1,662 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/** + * Implementation of greenlet::UserGreenlet. + * + * Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ +#ifndef T_USER_GREENLET_CPP +#define T_USER_GREENLET_CPP + +#include "greenlet_internal.hpp" +#include "TGreenlet.hpp" + +#include "TThreadStateDestroy.cpp" + + +namespace greenlet { +using greenlet::refs::BorrowedMainGreenlet; +greenlet::PythonAllocator UserGreenlet::allocator; + +void* UserGreenlet::operator new(size_t UNUSED(count)) +{ + return allocator.allocate(1); +} + + +void UserGreenlet::operator delete(void* ptr) +{ + return allocator.deallocate(static_cast(ptr), + 1); +} + + +UserGreenlet::UserGreenlet(PyGreenlet* p, BorrowedGreenlet the_parent) + : Greenlet(p), _parent(the_parent) +{ +} + +UserGreenlet::~UserGreenlet() +{ + // Python 3.11: If we don't clear out the raw frame datastack + // when deleting an unfinished greenlet, + // TestLeaks.test_untracked_memory_doesnt_increase_unfinished_thread_dealloc_in_main fails. + this->python_state.did_finish(nullptr); + this->tp_clear(); +} + + +const BorrowedMainGreenlet +UserGreenlet::main_greenlet() const +{ + return this->_main_greenlet; +} + + +BorrowedMainGreenlet +UserGreenlet::find_main_greenlet_in_lineage() const +{ + if (this->started()) { + assert(this->_main_greenlet); + return BorrowedMainGreenlet(this->_main_greenlet); + } + + if (!this->_parent) { + /* garbage collected greenlet in chain */ + // XXX: WHAT? + return BorrowedMainGreenlet(nullptr); + } + + return this->_parent->find_main_greenlet_in_lineage(); +} + + +/** + * CAUTION: This will allocate memory and may trigger garbage + * collection and arbitrary Python code. + */ +OwnedObject +UserGreenlet::throw_GreenletExit_during_dealloc(const ThreadState& current_thread_state) +{ + /* The dying greenlet cannot be a parent of ts_current + because the 'parent' field chain would hold a + reference */ + UserGreenlet::ParentIsCurrentGuard with_current_parent(this, current_thread_state); + + // We don't care about the return value, only whether an + // exception happened. Whether or not an exception happens, + // we need to restore the parent in case the greenlet gets + // resurrected. + return Greenlet::throw_GreenletExit_during_dealloc(current_thread_state); +} + +ThreadState* +UserGreenlet::thread_state() const noexcept +{ + // TODO: maybe make this throw, if the thread state isn't there? + // if (!this->main_greenlet) { + // throw std::runtime_error("No thread state"); // TODO: Better exception + // } + if (!this->_main_greenlet) { + return nullptr; + } + return this->_main_greenlet->thread_state(); +} + + +bool +UserGreenlet::was_running_in_dead_thread() const noexcept +{ + return this->_main_greenlet && !this->thread_state(); +} + +OwnedObject +UserGreenlet::g_switch() +{ + assert(this->args() || PyErr_Occurred()); + + try { + this->check_switch_allowed(); + } + catch (const PyErrOccurred&) { + this->release_args(); + throw; + } + + // Switching greenlets used to attempt to clean out ones that need + // deleted *if* we detected a thread switch. Should it still do + // that? + // An issue is that if we delete a greenlet from another thread, + // it gets queued to this thread, and ``kill_greenlet()`` switches + // back into the greenlet + + /* find the real target by ignoring dead greenlets, + and if necessary starting a greenlet. */ + switchstack_result_t err; + Greenlet* target = this; + // TODO: probably cleaner to handle the case where we do + // switch to ourself separately from the other cases. + // This can probably even further be simplified if we keep + // track of the switching_state we're going for and just call + // into g_switch() if it's not ourself. The main problem with that + // is that we would be using more stack space. + bool target_was_me = true; + bool was_initial_stub = false; + while (target) { + if (target->active()) { + if (!target_was_me) { + target->args() <<= this->args(); + assert(!this->args()); + } + err = target->g_switchstack(); + break; + } + if (!target->started()) { + // We never encounter a main greenlet that's not started. + assert(!target->main()); + UserGreenlet* real_target = static_cast(target); + assert(real_target); + void* dummymarker; + was_initial_stub = true; + if (!target_was_me) { + target->args() <<= this->args(); + assert(!this->args()); + } + try { + // This can only throw back to us while we're + // still in this greenlet. Once the new greenlet + // is bootstrapped, it has its own exception state. + err = real_target->g_initialstub(&dummymarker); + } + catch (const PyErrOccurred&) { + this->release_args(); + throw; + } + catch (const GreenletStartedWhileInPython&) { + // The greenlet was started sometime before this + // greenlet actually switched to it, i.e., + // "concurrent" calls to switch() or throw(). + // We need to retry the switch. + // Note that the current greenlet has been reset + // to this one (or we wouldn't be running!) + continue; + } + break; + } + + target = target->parent(); + target_was_me = false; + } + // The ``this`` pointer and all other stack or register based + // variables are invalid now, at least where things succeed + // above. + // But this one, probably not so much? It's not clear if it's + // safe to throw an exception at this point. + + if (err.status < 0) { + // If we get here, either g_initialstub() + // failed, or g_switchstack() failed. Either one of those + // cases SHOULD leave us in the original greenlet with a valid + // stack. + return this->on_switchstack_or_initialstub_failure(target, err, target_was_me, was_initial_stub); + } + + // err.the_new_current_greenlet would be the same as ``target``, + // if target wasn't probably corrupt. + return err.the_new_current_greenlet->g_switch_finish(err); +} + + + +Greenlet::switchstack_result_t +UserGreenlet::g_initialstub(void* mark) +{ + OwnedObject run; + + // We need to grab a reference to the current switch arguments + // in case we're entered concurrently during the call to + // GetAttr() and have to try again. + // We'll restore them when we return in that case. + // Scope them tightly to avoid ref leaks. + { + SwitchingArgs args(this->args()); + + /* save exception in case getattr clears it */ + PyErrPieces saved; + + /* + self.run is the object to call in the new greenlet. + This could run arbitrary python code and switch greenlets! + */ + run = this->self().PyRequireAttr(mod_globs->str_run); + /* restore saved exception */ + saved.PyErrRestore(); + + + /* recheck that it's safe to switch in case greenlet reparented anywhere above */ + this->check_switch_allowed(); + + /* by the time we got here another start could happen elsewhere, + * that means it should now be a regular switch. + * This can happen if the Python code is a subclass that implements + * __getattribute__ or __getattr__, or makes ``run`` a descriptor; + * all of those can run arbitrary code that switches back into + * this greenlet. + */ + if (this->stack_state.started()) { + // the successful switch cleared these out, we need to + // restore our version. They will be copied on up to the + // next target. + assert(!this->args()); + this->args() <<= args; + throw GreenletStartedWhileInPython(); + } + } + + // Sweet, if we got here, we have the go-ahead and will switch + // greenlets. + // Nothing we do from here on out should allow for a thread or + // greenlet switch: No arbitrary calls to Python, including + // decref'ing + +#if GREENLET_USE_CFRAME + /* OK, we need it, we're about to switch greenlets, save the state. */ + /* + See green_new(). This is a stack-allocated variable used + while *self* is in PyObject_Call(). + We want to defer copying the state info until we're sure + we need it and are in a stable place to do so. + */ + _PyCFrame trace_info; + + this->python_state.set_new_cframe(trace_info); +#endif + /* start the greenlet */ + ThreadState& thread_state = GET_THREAD_STATE().state(); + this->stack_state = StackState(mark, + thread_state.borrow_current()->stack_state); + this->python_state.set_initial_state(PyThreadState_GET()); + this->exception_state.clear(); + this->_main_greenlet = thread_state.get_main_greenlet(); + + /* perform the initial switch */ + switchstack_result_t err = this->g_switchstack(); + /* returns twice! + The 1st time with ``err == 1``: we are in the new greenlet. + This one owns a greenlet that used to be current. + The 2nd time with ``err <= 0``: back in the caller's + greenlet; this happens if the child finishes or switches + explicitly to us. Either way, the ``err`` variable is + created twice at the same memory location, but possibly + having different ``origin`` values. Note that it's not + constructed for the second time until the switch actually happens. + */ + if (err.status == 1) { + // In the new greenlet. + + // This never returns! Calling inner_bootstrap steals + // the contents of our run object within this stack frame, so + // it is not valid to do anything with it. + try { + this->inner_bootstrap(err.origin_greenlet.relinquish_ownership(), + run.relinquish_ownership()); + } + // Getting a C++ exception here isn't good. It's probably a + // bug in the underlying greenlet, meaning it's probably a + // C++ extension. We're going to abort anyway, but try to + // display some nice information *if* possible. Some obscure + // platforms don't properly support this (old 32-bit Arm, see see + // https://github.com/python-greenlet/greenlet/issues/385); that's not + // great, but should usually be OK because, as mentioned above, we're + // terminating anyway. + // + // The catching is tested by + // ``test_cpp.CPPTests.test_unhandled_exception_in_greenlet_aborts``. + // + // PyErrOccurred can theoretically be thrown by + // inner_bootstrap() -> g_switch_finish(), but that should + // never make it back to here. It is a std::exception and + // would be caught if it is. + catch (const std::exception& e) { + std::string base = "greenlet: Unhandled C++ exception: "; + base += e.what(); + Py_FatalError(base.c_str()); + } + catch (...) { + // Some compilers/runtimes use exceptions internally. + // It appears that GCC on Linux with libstdc++ throws an + // exception internally at process shutdown time to unwind + // stacks and clean up resources. Depending on exactly + // where we are when the process exits, that could result + // in an unknown exception getting here. If we + // Py_FatalError() or abort() here, we interfere with + // orderly process shutdown. Throwing the exception on up + // is the right thing to do. + // + // gevent's ``examples/dns_mass_resolve.py`` demonstrates this. +#ifndef NDEBUG + fprintf(stderr, + "greenlet: inner_bootstrap threw unknown exception; " + "is the process terminating?\n"); +#endif + throw; + } + Py_FatalError("greenlet: inner_bootstrap returned with no exception.\n"); + } + + + // In contrast, notice that we're keeping the origin greenlet + // around as an owned reference; we need it to call the trace + // function for the switch back into the parent. It was only + // captured at the time the switch actually happened, though, + // so we haven't been keeping an extra reference around this + // whole time. + + /* back in the parent */ + if (err.status < 0) { + /* start failed badly, restore greenlet state */ + this->stack_state = StackState(); + this->_main_greenlet.CLEAR(); + // CAUTION: This may run arbitrary Python code. + run.CLEAR(); // inner_bootstrap didn't run, we own the reference. + } + + // In the success case, the spawned code (inner_bootstrap) will + // take care of decrefing this, so we relinquish ownership so as + // to not double-decref. + + run.relinquish_ownership(); + + return err; +} + + +void +UserGreenlet::inner_bootstrap(PyGreenlet* origin_greenlet, PyObject* run) +{ + // The arguments here would be another great place for move. + // As it is, we take them as a reference so that when we clear + // them we clear what's on the stack above us. Do that NOW, and + // without using a C++ RAII object, + // so there's no way that exiting the parent frame can clear it, + // or we clear it unexpectedly. This arises in the context of the + // interpreter shutting down. See https://github.com/python-greenlet/greenlet/issues/325 + //PyObject* run = _run.relinquish_ownership(); + + /* in the new greenlet */ + assert(this->thread_state()->borrow_current() == BorrowedGreenlet(this->_self)); + // C++ exceptions cannot propagate to the parent greenlet from + // here. (TODO: Do we need a catch(...) clause, perhaps on the + // function itself? ALl we could do is terminate the program.) + // NOTE: On 32-bit Windows, the call chain is extremely + // important here in ways that are subtle, having to do with + // the depth of the SEH list. The call to restore it MUST NOT + // add a new SEH handler to the list, or we'll restore it to + // the wrong thing. + this->thread_state()->restore_exception_state(); + /* stack variables from above are no good and also will not unwind! */ + // EXCEPT: That can't be true, we access run, among others, here. + + this->stack_state.set_active(); /* running */ + + // We're about to possibly run Python code again, which + // could switch back/away to/from us, so we need to grab the + // arguments locally. + SwitchingArgs args; + args <<= this->args(); + assert(!this->args()); + + // XXX: We could clear this much earlier, right? + // Or would that introduce the possibility of running Python + // code when we don't want to? + // CAUTION: This may run arbitrary Python code. + this->_run_callable.CLEAR(); + + + // The first switch we need to manually call the trace + // function here instead of in g_switch_finish, because we + // never return there. + if (OwnedObject tracefunc = this->thread_state()->get_tracefunc()) { + OwnedGreenlet trace_origin; + trace_origin = origin_greenlet; + try { + g_calltrace(tracefunc, + args ? mod_globs->event_switch : mod_globs->event_throw, + trace_origin, + this->_self); + } + catch (const PyErrOccurred&) { + /* Turn trace errors into switch throws */ + args.CLEAR(); + } + } + + // We no longer need the origin, it was only here for + // tracing. + // We may never actually exit this stack frame so we need + // to explicitly clear it. + // This could run Python code and switch. + Py_CLEAR(origin_greenlet); + + OwnedObject result; + if (!args) { + /* pending exception */ + result = NULL; + } + else { + /* call g.run(*args, **kwargs) */ + // This could result in further switches + try { + //result = run.PyCall(args.args(), args.kwargs()); + // CAUTION: Just invoking this, before the function even + // runs, may cause memory allocations, which may trigger + // GC, which may run arbitrary Python code. + result = OwnedObject::consuming(PyObject_Call(run, args.args().borrow(), args.kwargs().borrow())); + } + catch (...) { + // Unhandled C++ exception! + + // If we declare ourselves as noexcept, if we don't catch + // this here, most platforms will just abort() the + // process. But on 64-bit Windows with older versions of + // the C runtime, this can actually corrupt memory and + // just return. We see this when compiling with the + // Windows 7.0 SDK targeting Windows Server 2008, but not + // when using the Appveyor Visual Studio 2019 image. So + // this currently only affects Python 2.7 on Windows 64. + // That is, the tests pass and the runtime aborts + // everywhere else. + // + // However, if we catch it and try to continue with a + // Python error, then all Windows 64 bit platforms corrupt + // memory. So all we can do is manually abort, hopefully + // with a good error message. (Note that the above was + // tested WITHOUT the `/EHr` switch being used at compile + // time, so MSVC may have "optimized" out important + // checking. Using that switch, we may be in a better + // place in terms of memory corruption.) But sometimes it + // can't be caught here at all, which is confusing but not + // terribly surprising; so again, the G_NOEXCEPT_WIN32 + // plus "/EHr". + // + // Hopefully the basic C stdlib is still functional enough + // for us to at least print an error. + // + // It gets more complicated than that, though, on some + // platforms, specifically at least Linux/gcc/libstdc++. They use + // an exception to unwind the stack when a background + // thread exits. (See comments about noexcept.) So this + // may not actually represent anything untoward. On those + // platforms we allow throws of this to propagate, or + // attempt to anyway. +# if defined(WIN32) || defined(_WIN32) + Py_FatalError( + "greenlet: Unhandled C++ exception from a greenlet run function. " + "Because memory is likely corrupted, terminating process."); + std::abort(); +#else + throw; +#endif + } + } + // These lines may run arbitrary code + args.CLEAR(); + Py_CLEAR(run); + + if (!result + && mod_globs->PyExc_GreenletExit.PyExceptionMatches() + && (this->args())) { + // This can happen, for example, if our only reference + // goes away after we switch back to the parent. + // See test_dealloc_switch_args_not_lost + PyErrPieces clear_error; + result <<= this->args(); + result = single_result(result); + } + this->release_args(); + this->python_state.did_finish(PyThreadState_GET()); + + result = g_handle_exit(result); + assert(this->thread_state()->borrow_current() == this->_self); + + /* jump back to parent */ + this->stack_state.set_inactive(); /* dead */ + + + // TODO: Can we decref some things here? Release our main greenlet + // and maybe parent? + for (Greenlet* parent = this->_parent; + parent; + parent = parent->parent()) { + // We need to somewhere consume a reference to + // the result; in most cases we'll never have control + // back in this stack frame again. Calling + // green_switch actually adds another reference! + // This would probably be clearer with a specific API + // to hand results to the parent. + parent->args() <<= result; + assert(!result); + // The parent greenlet now owns the result; in the + // typical case we'll never get back here to assign to + // result and thus release the reference. + try { + result = parent->g_switch(); + } + catch (const PyErrOccurred&) { + // Ignore, keep passing the error on up. + } + + /* Return here means switch to parent failed, + * in which case we throw *current* exception + * to the next parent in chain. + */ + assert(!result); + } + /* We ran out of parents, cannot continue */ + PyErr_WriteUnraisable(this->self().borrow_o()); + Py_FatalError("greenlet: ran out of parent greenlets while propagating exception; " + "cannot continue"); + std::abort(); +} + +void +UserGreenlet::run(const BorrowedObject nrun) +{ + if (this->started()) { + throw AttributeError( + "run cannot be set " + "after the start of the greenlet"); + } + this->_run_callable = nrun; +} + +const OwnedGreenlet +UserGreenlet::parent() const +{ + return this->_parent; +} + +void +UserGreenlet::parent(const BorrowedObject raw_new_parent) +{ + if (!raw_new_parent) { + throw AttributeError("can't delete attribute"); + } + + BorrowedMainGreenlet main_greenlet_of_new_parent; + BorrowedGreenlet new_parent(raw_new_parent.borrow()); // could + // throw + // TypeError! + for (BorrowedGreenlet p = new_parent; p; p = p->parent()) { + if (p == this->self()) { + throw ValueError("cyclic parent chain"); + } + main_greenlet_of_new_parent = p->main_greenlet(); + } + + if (!main_greenlet_of_new_parent) { + throw ValueError("parent must not be garbage collected"); + } + + if (this->started() + && this->_main_greenlet != main_greenlet_of_new_parent) { + throw ValueError("parent cannot be on a different thread"); + } + + this->_parent = new_parent; +} + +void +UserGreenlet::murder_in_place() +{ + this->_main_greenlet.CLEAR(); + Greenlet::murder_in_place(); +} + +bool +UserGreenlet::belongs_to_thread(const ThreadState* thread_state) const +{ + return Greenlet::belongs_to_thread(thread_state) && this->_main_greenlet == thread_state->borrow_main_greenlet(); +} + + +int +UserGreenlet::tp_traverse(visitproc visit, void* arg) +{ + Py_VISIT(this->_parent.borrow_o()); + Py_VISIT(this->_main_greenlet.borrow_o()); + Py_VISIT(this->_run_callable.borrow_o()); + + return Greenlet::tp_traverse(visit, arg); +} + +int +UserGreenlet::tp_clear() +{ + Greenlet::tp_clear(); + this->_parent.CLEAR(); + this->_main_greenlet.CLEAR(); + this->_run_callable.CLEAR(); + return 0; +} + +UserGreenlet::ParentIsCurrentGuard::ParentIsCurrentGuard(UserGreenlet* p, + const ThreadState& thread_state) + : oldparent(p->_parent), + greenlet(p) +{ + p->_parent = thread_state.get_current(); +} + +UserGreenlet::ParentIsCurrentGuard::~ParentIsCurrentGuard() +{ + this->greenlet->_parent = oldparent; + oldparent.CLEAR(); +} + +}; //namespace greenlet +#endif diff --git a/.venv/Lib/site-packages/greenlet/__init__.py b/.venv/Lib/site-packages/greenlet/__init__.py new file mode 100644 index 0000000..b2dcc9b --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/__init__.py @@ -0,0 +1,71 @@ +# -*- coding: utf-8 -*- +""" +The root of the greenlet package. +""" +from __future__ import absolute_import +from __future__ import division +from __future__ import print_function + +__all__ = [ + '__version__', + '_C_API', + + 'GreenletExit', + 'error', + + 'getcurrent', + 'greenlet', + + 'gettrace', + 'settrace', +] + +# pylint:disable=no-name-in-module + +### +# Metadata +### +__version__ = '3.1.1' +from ._greenlet import _C_API # pylint:disable=no-name-in-module + +### +# Exceptions +### +from ._greenlet import GreenletExit +from ._greenlet import error + +### +# greenlets +### +from ._greenlet import getcurrent +from ._greenlet import greenlet + +### +# tracing +### +try: + from ._greenlet import gettrace + from ._greenlet import settrace +except ImportError: + # Tracing wasn't supported. + # XXX: The option to disable it was removed in 1.0, + # so this branch should be dead code. + pass + +### +# Constants +# These constants aren't documented and aren't recommended. +# In 1.0, USE_GC and USE_TRACING are always true, and USE_CONTEXT_VARS +# is the same as ``sys.version_info[:2] >= 3.7`` +### +from ._greenlet import GREENLET_USE_CONTEXT_VARS # pylint:disable=unused-import +from ._greenlet import GREENLET_USE_GC # pylint:disable=unused-import +from ._greenlet import GREENLET_USE_TRACING # pylint:disable=unused-import + +# Controlling the use of the gc module. Provisional API for this greenlet +# implementation in 2.0. +from ._greenlet import CLOCKS_PER_SEC # pylint:disable=unused-import +from ._greenlet import enable_optional_cleanup # pylint:disable=unused-import +from ._greenlet import get_clocks_used_doing_optional_cleanup # pylint:disable=unused-import + +# Other APIS in the _greenlet module are for test support. diff --git a/.venv/Lib/site-packages/greenlet/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1be09ec49e9d6a45426fc423f44f502009efd513 GIT binary patch literal 1092 zcmZXS!EVz)5Qb+HC$XKRX`8eN1frs)C@KUBClDY-kyTYxZPliTt}LxwdkLnFZLK$j z_S6U9&Yc^t04L78fu(Tagv23$A|X!9I_&{rS^s=HGnRM$-Otsk3HXe+hP{tPfUjzC z{%B|L>pQ|*@PL9xyj(!~IhrGi^T>Ic&sam&s79a%Uf~^~1+PepUdhvgQeUS!_LMvW z*`P+oCbCJ*jLXPnTF$tFT%i>LhWet4t17K#l_}&YI+bw^d74gVJdHdxoZgElg5AkWb`0>^WUz-vn&aDsh!bMqCv&hNu3(wsk8G`lbOf`}ry5ItXz z$UVV%7;w1|JMN*=<1O=>@~27Cnsbmu!9a56_v1)NOzEC~L;tj!Ip%l39H*4f(ZTF<)dX?tf^ z4fs!St%Iq?KdJ6cyR*KzriSfoY;~UOvTbXJ?OLky0uP;ofU_u8(>nok1MY-_7)#4I z2QDM`Fkyp)d(4acu=ii*W^+C*F)X@hm&wpcIS`yNk;lCYbxTD7MfEsAfO)*gkQ(gV zugndhyb#I>p?t_(5Xu9g97xOS+0j|bbx~94X(cmCW|h>HG*I5dFI4!`?>w;g5hX{ZM@GU9qF!PjpfV?pS$}YN|Bl@{;^C3K;UCzE zFZr#rdzIMd`@YSXANrE9R(zc55Brff2>4@h1^=#&Iq9Q}@`R8dT8?PrB9I$HxH^RE zKeb9ZcUl@PLv8-FJcKJ_6UfpKE~|JAdq!r77(;Cl-|;0Nt3y~G!pc|&g0b}l9{nCQ jL9hP=jTk?4C>SFH=})5U_)uxDz^9c$`(FOjU4r@-u&gH& literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/_greenlet.cp312-win_amd64.pyd b/.venv/Lib/site-packages/greenlet/_greenlet.cp312-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..435a41a9ab5372699b7226e25910d3edebe00e38 GIT binary patch literal 219136 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 Qu%kO%Y1qp3G5_s)10*_ooB#j- literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/greenlet.cpp b/.venv/Lib/site-packages/greenlet/greenlet.cpp new file mode 100644 index 0000000..e8d92a0 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet.cpp @@ -0,0 +1,320 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +/* Format with: + * clang-format -i --style=file src/greenlet/greenlet.c + * + * + * Fix missing braces with: + * clang-tidy src/greenlet/greenlet.c -fix -checks="readability-braces-around-statements" +*/ +#include +#include +#include +#include + + +#define PY_SSIZE_T_CLEAN +#include +#include "structmember.h" // PyMemberDef + +#include "greenlet_internal.hpp" +// Code after this point can assume access to things declared in stdint.h, +// including the fixed-width types. This goes for the platform-specific switch functions +// as well. +#include "greenlet_refs.hpp" +#include "greenlet_slp_switch.hpp" + +#include "greenlet_thread_support.hpp" +#include "TGreenlet.hpp" + +#include "TGreenletGlobals.cpp" + +#include "TGreenlet.cpp" +#include "TMainGreenlet.cpp" +#include "TUserGreenlet.cpp" +#include "TBrokenGreenlet.cpp" +#include "TExceptionState.cpp" +#include "TPythonState.cpp" +#include "TStackState.cpp" + +#include "TThreadState.hpp" +#include "TThreadStateCreator.hpp" +#include "TThreadStateDestroy.cpp" + +#include "PyGreenlet.cpp" +#include "PyGreenletUnswitchable.cpp" +#include "CObjects.cpp" + +using greenlet::LockGuard; +using greenlet::LockInitError; +using greenlet::PyErrOccurred; +using greenlet::Require; + +using greenlet::g_handle_exit; +using greenlet::single_result; + +using greenlet::Greenlet; +using greenlet::UserGreenlet; +using greenlet::MainGreenlet; +using greenlet::BrokenGreenlet; +using greenlet::ThreadState; +using greenlet::PythonState; + + + +// ******* Implementation of things from included files +template +greenlet::refs::_BorrowedGreenlet& greenlet::refs::_BorrowedGreenlet::operator=(const greenlet::refs::BorrowedObject& other) +{ + this->_set_raw_pointer(static_cast(other)); + return *this; +} + +template +inline greenlet::refs::_BorrowedGreenlet::operator Greenlet*() const noexcept +{ + if (!this->p) { + return nullptr; + } + return reinterpret_cast(this->p)->pimpl; +} + +template +greenlet::refs::_BorrowedGreenlet::_BorrowedGreenlet(const BorrowedObject& p) + : BorrowedReference(nullptr) +{ + + this->_set_raw_pointer(p.borrow()); +} + +template +inline greenlet::refs::_OwnedGreenlet::operator Greenlet*() const noexcept +{ + if (!this->p) { + return nullptr; + } + return reinterpret_cast(this->p)->pimpl; +} + + + +#ifdef __clang__ +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wmissing-field-initializers" +# pragma clang diagnostic ignored "-Wwritable-strings" +#elif defined(__GNUC__) +# pragma GCC diagnostic push +// warning: ISO C++ forbids converting a string constant to ‘char*’ +// (The python APIs aren't const correct and accept writable char*) +# pragma GCC diagnostic ignored "-Wwrite-strings" +#endif + + +/*********************************************************** + +A PyGreenlet is a range of C stack addresses that must be +saved and restored in such a way that the full range of the +stack contains valid data when we switch to it. + +Stack layout for a greenlet: + + | ^^^ | + | older data | + | | + stack_stop . |_______________| + . | | + . | greenlet data | + . | in stack | + . * |_______________| . . _____________ stack_copy + stack_saved + . | | | | + . | data | |greenlet data| + . | unrelated | | saved | + . | to | | in heap | + stack_start . | this | . . |_____________| stack_copy + | greenlet | + | | + | newer data | + | vvv | + + +Note that a greenlet's stack data is typically partly at its correct +place in the stack, and partly saved away in the heap, but always in +the above configuration: two blocks, the more recent one in the heap +and the older one still in the stack (either block may be empty). + +Greenlets are chained: each points to the previous greenlet, which is +the one that owns the data currently in the C stack above my +stack_stop. The currently running greenlet is the first element of +this chain. The main (initial) greenlet is the last one. Greenlets +whose stack is entirely in the heap can be skipped from the chain. + +The chain is not related to execution order, but only to the order +in which bits of C stack happen to belong to greenlets at a particular +point in time. + +The main greenlet doesn't have a stack_stop: it is responsible for the +complete rest of the C stack, and we don't know where it begins. We +use (char*) -1, the largest possible address. + +States: + stack_stop == NULL && stack_start == NULL: did not start yet + stack_stop != NULL && stack_start == NULL: already finished + stack_stop != NULL && stack_start != NULL: active + +The running greenlet's stack_start is undefined but not NULL. + + ***********************************************************/ + + + + +/***********************************************************/ + +/* Some functions must not be inlined: + * slp_restore_state, when inlined into slp_switch might cause + it to restore stack over its own local variables + * slp_save_state, when inlined would add its own local + variables to the saved stack, wasting space + * slp_switch, cannot be inlined for obvious reasons + * g_initialstub, when inlined would receive a pointer into its + own stack frame, leading to incomplete stack save/restore + +g_initialstub is a member function and declared virtual so that the +compiler always calls it through a vtable. + +slp_save_state and slp_restore_state are also member functions. They +are called from trampoline functions that themselves are declared as +not eligible for inlining. +*/ + +extern "C" { +static int GREENLET_NOINLINE(slp_save_state_trampoline)(char* stackref) +{ + return switching_thread_state->slp_save_state(stackref); +} +static void GREENLET_NOINLINE(slp_restore_state_trampoline)() +{ + switching_thread_state->slp_restore_state(); +} +} + + +/***********************************************************/ + + +#include "PyModule.cpp" + + + +static PyObject* +greenlet_internal_mod_init() noexcept +{ + static void* _PyGreenlet_API[PyGreenlet_API_pointers]; + + try { + CreatedModule m(greenlet_module_def); + + Require(PyType_Ready(&PyGreenlet_Type)); + Require(PyType_Ready(&PyGreenletUnswitchable_Type)); + + mod_globs = new greenlet::GreenletGlobals; + ThreadState::init(); + + m.PyAddObject("greenlet", PyGreenlet_Type); + m.PyAddObject("UnswitchableGreenlet", PyGreenletUnswitchable_Type); + m.PyAddObject("error", mod_globs->PyExc_GreenletError); + m.PyAddObject("GreenletExit", mod_globs->PyExc_GreenletExit); + + m.PyAddObject("GREENLET_USE_GC", 1); + m.PyAddObject("GREENLET_USE_TRACING", 1); + m.PyAddObject("GREENLET_USE_CONTEXT_VARS", 1L); + m.PyAddObject("GREENLET_USE_STANDARD_THREADING", 1L); + + OwnedObject clocks_per_sec = OwnedObject::consuming(PyLong_FromSsize_t(CLOCKS_PER_SEC)); + m.PyAddObject("CLOCKS_PER_SEC", clocks_per_sec); + + /* also publish module-level data as attributes of the greentype. */ + // XXX: This is weird, and enables a strange pattern of + // confusing the class greenlet with the module greenlet; with + // the exception of (possibly) ``getcurrent()``, this + // shouldn't be encouraged so don't add new items here. + for (const char* const* p = copy_on_greentype; *p; p++) { + OwnedObject o = m.PyRequireAttr(*p); + PyDict_SetItemString(PyGreenlet_Type.tp_dict, *p, o.borrow()); + } + + /* + * Expose C API + */ + + /* types */ + _PyGreenlet_API[PyGreenlet_Type_NUM] = (void*)&PyGreenlet_Type; + + /* exceptions */ + _PyGreenlet_API[PyExc_GreenletError_NUM] = (void*)mod_globs->PyExc_GreenletError; + _PyGreenlet_API[PyExc_GreenletExit_NUM] = (void*)mod_globs->PyExc_GreenletExit; + + /* methods */ + _PyGreenlet_API[PyGreenlet_New_NUM] = (void*)PyGreenlet_New; + _PyGreenlet_API[PyGreenlet_GetCurrent_NUM] = (void*)PyGreenlet_GetCurrent; + _PyGreenlet_API[PyGreenlet_Throw_NUM] = (void*)PyGreenlet_Throw; + _PyGreenlet_API[PyGreenlet_Switch_NUM] = (void*)PyGreenlet_Switch; + _PyGreenlet_API[PyGreenlet_SetParent_NUM] = (void*)PyGreenlet_SetParent; + + /* Previously macros, but now need to be functions externally. */ + _PyGreenlet_API[PyGreenlet_MAIN_NUM] = (void*)Extern_PyGreenlet_MAIN; + _PyGreenlet_API[PyGreenlet_STARTED_NUM] = (void*)Extern_PyGreenlet_STARTED; + _PyGreenlet_API[PyGreenlet_ACTIVE_NUM] = (void*)Extern_PyGreenlet_ACTIVE; + _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM] = (void*)Extern_PyGreenlet_GET_PARENT; + + /* XXX: Note that our module name is ``greenlet._greenlet``, but for + backwards compatibility with existing C code, we need the _C_API to + be directly in greenlet. + */ + const NewReference c_api_object(Require( + PyCapsule_New( + (void*)_PyGreenlet_API, + "greenlet._C_API", + NULL))); + m.PyAddObject("_C_API", c_api_object); + assert(c_api_object.REFCNT() == 2); + + // cerr << "Sizes:" + // << "\n\tGreenlet : " << sizeof(Greenlet) + // << "\n\tUserGreenlet : " << sizeof(UserGreenlet) + // << "\n\tMainGreenlet : " << sizeof(MainGreenlet) + // << "\n\tExceptionState : " << sizeof(greenlet::ExceptionState) + // << "\n\tPythonState : " << sizeof(greenlet::PythonState) + // << "\n\tStackState : " << sizeof(greenlet::StackState) + // << "\n\tSwitchingArgs : " << sizeof(greenlet::SwitchingArgs) + // << "\n\tOwnedObject : " << sizeof(greenlet::refs::OwnedObject) + // << "\n\tBorrowedObject : " << sizeof(greenlet::refs::BorrowedObject) + // << "\n\tPyGreenlet : " << sizeof(PyGreenlet) + // << endl; + + return m.borrow(); // But really it's the main reference. + } + catch (const LockInitError& e) { + PyErr_SetString(PyExc_MemoryError, e.what()); + return NULL; + } + catch (const PyErrOccurred&) { + return NULL; + } + +} + +extern "C" { + +PyMODINIT_FUNC +PyInit__greenlet(void) +{ + return greenlet_internal_mod_init(); +} + +}; // extern C + +#ifdef __clang__ +# pragma clang diagnostic pop +#elif defined(__GNUC__) +# pragma GCC diagnostic pop +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet.h b/.venv/Lib/site-packages/greenlet/greenlet.h new file mode 100644 index 0000000..d02a16e --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet.h @@ -0,0 +1,164 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ + +/* Greenlet object interface */ + +#ifndef Py_GREENLETOBJECT_H +#define Py_GREENLETOBJECT_H + + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/* This is deprecated and undocumented. It does not change. */ +#define GREENLET_VERSION "1.0.0" + +#ifndef GREENLET_MODULE +#define implementation_ptr_t void* +#endif + +typedef struct _greenlet { + PyObject_HEAD + PyObject* weakreflist; + PyObject* dict; + implementation_ptr_t pimpl; +} PyGreenlet; + +#define PyGreenlet_Check(op) (op && PyObject_TypeCheck(op, &PyGreenlet_Type)) + + +/* C API functions */ + +/* Total number of symbols that are exported */ +#define PyGreenlet_API_pointers 12 + +#define PyGreenlet_Type_NUM 0 +#define PyExc_GreenletError_NUM 1 +#define PyExc_GreenletExit_NUM 2 + +#define PyGreenlet_New_NUM 3 +#define PyGreenlet_GetCurrent_NUM 4 +#define PyGreenlet_Throw_NUM 5 +#define PyGreenlet_Switch_NUM 6 +#define PyGreenlet_SetParent_NUM 7 + +#define PyGreenlet_MAIN_NUM 8 +#define PyGreenlet_STARTED_NUM 9 +#define PyGreenlet_ACTIVE_NUM 10 +#define PyGreenlet_GET_PARENT_NUM 11 + +#ifndef GREENLET_MODULE +/* This section is used by modules that uses the greenlet C API */ +static void** _PyGreenlet_API = NULL; + +# define PyGreenlet_Type \ + (*(PyTypeObject*)_PyGreenlet_API[PyGreenlet_Type_NUM]) + +# define PyExc_GreenletError \ + ((PyObject*)_PyGreenlet_API[PyExc_GreenletError_NUM]) + +# define PyExc_GreenletExit \ + ((PyObject*)_PyGreenlet_API[PyExc_GreenletExit_NUM]) + +/* + * PyGreenlet_New(PyObject *args) + * + * greenlet.greenlet(run, parent=None) + */ +# define PyGreenlet_New \ + (*(PyGreenlet * (*)(PyObject * run, PyGreenlet * parent)) \ + _PyGreenlet_API[PyGreenlet_New_NUM]) + +/* + * PyGreenlet_GetCurrent(void) + * + * greenlet.getcurrent() + */ +# define PyGreenlet_GetCurrent \ + (*(PyGreenlet * (*)(void)) _PyGreenlet_API[PyGreenlet_GetCurrent_NUM]) + +/* + * PyGreenlet_Throw( + * PyGreenlet *greenlet, + * PyObject *typ, + * PyObject *val, + * PyObject *tb) + * + * g.throw(...) + */ +# define PyGreenlet_Throw \ + (*(PyObject * (*)(PyGreenlet * self, \ + PyObject * typ, \ + PyObject * val, \ + PyObject * tb)) \ + _PyGreenlet_API[PyGreenlet_Throw_NUM]) + +/* + * PyGreenlet_Switch(PyGreenlet *greenlet, PyObject *args) + * + * g.switch(*args, **kwargs) + */ +# define PyGreenlet_Switch \ + (*(PyObject * \ + (*)(PyGreenlet * greenlet, PyObject * args, PyObject * kwargs)) \ + _PyGreenlet_API[PyGreenlet_Switch_NUM]) + +/* + * PyGreenlet_SetParent(PyObject *greenlet, PyObject *new_parent) + * + * g.parent = new_parent + */ +# define PyGreenlet_SetParent \ + (*(int (*)(PyGreenlet * greenlet, PyGreenlet * nparent)) \ + _PyGreenlet_API[PyGreenlet_SetParent_NUM]) + +/* + * PyGreenlet_GetParent(PyObject* greenlet) + * + * return greenlet.parent; + * + * This could return NULL even if there is no exception active. + * If it does not return NULL, you are responsible for decrementing the + * reference count. + */ +# define PyGreenlet_GetParent \ + (*(PyGreenlet* (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_GET_PARENT_NUM]) + +/* + * deprecated, undocumented alias. + */ +# define PyGreenlet_GET_PARENT PyGreenlet_GetParent + +# define PyGreenlet_MAIN \ + (*(int (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_MAIN_NUM]) + +# define PyGreenlet_STARTED \ + (*(int (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_STARTED_NUM]) + +# define PyGreenlet_ACTIVE \ + (*(int (*)(PyGreenlet*)) \ + _PyGreenlet_API[PyGreenlet_ACTIVE_NUM]) + + + + +/* Macro that imports greenlet and initializes C API */ +/* NOTE: This has actually moved to ``greenlet._greenlet._C_API``, but we + keep the older definition to be sure older code that might have a copy of + the header still works. */ +# define PyGreenlet_Import() \ + { \ + _PyGreenlet_API = (void**)PyCapsule_Import("greenlet._C_API", 0); \ + } + +#endif /* GREENLET_MODULE */ + +#ifdef __cplusplus +} +#endif +#endif /* !Py_GREENLETOBJECT_H */ diff --git a/.venv/Lib/site-packages/greenlet/greenlet_allocator.hpp b/.venv/Lib/site-packages/greenlet/greenlet_allocator.hpp new file mode 100644 index 0000000..b452f54 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_allocator.hpp @@ -0,0 +1,63 @@ +#ifndef GREENLET_ALLOCATOR_HPP +#define GREENLET_ALLOCATOR_HPP + +#define PY_SSIZE_T_CLEAN +#include +#include +#include "greenlet_compiler_compat.hpp" + + +namespace greenlet +{ + // This allocator is stateless; all instances are identical. + // It can *ONLY* be used when we're sure we're holding the GIL + // (Python's allocators require the GIL). + template + struct PythonAllocator : public std::allocator { + + PythonAllocator(const PythonAllocator& UNUSED(other)) + : std::allocator() + { + } + + PythonAllocator(const std::allocator other) + : std::allocator(other) + {} + + template + PythonAllocator(const std::allocator& other) + : std::allocator(other) + { + } + + PythonAllocator() : std::allocator() {} + + T* allocate(size_t number_objects, const void* UNUSED(hint)=0) + { + void* p; + if (number_objects == 1) + p = PyObject_Malloc(sizeof(T)); + else + p = PyMem_Malloc(sizeof(T) * number_objects); + return static_cast(p); + } + + void deallocate(T* t, size_t n) + { + void* p = t; + if (n == 1) { + PyObject_Free(p); + } + else + PyMem_Free(p); + } + // This member is deprecated in C++17 and removed in C++20 + template< class U > + struct rebind { + typedef PythonAllocator other; + }; + + }; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp b/.venv/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp new file mode 100644 index 0000000..af24bd8 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_compiler_compat.hpp @@ -0,0 +1,98 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +#ifndef GREENLET_COMPILER_COMPAT_HPP +#define GREENLET_COMPILER_COMPAT_HPP + +/** + * Definitions to aid with compatibility with different compilers. + * + * .. caution:: Use extreme care with noexcept. + * Some compilers and runtimes, specifically gcc/libgcc/libstdc++ on + * Linux, implement stack unwinding by throwing an uncatchable + * exception, one that specifically does not appear to be an active + * exception to the rest of the runtime. If this happens while we're in a noexcept function, + * we have violated our dynamic exception contract, and so the runtime + * will call std::terminate(), which kills the process with the + * unhelpful message "terminate called without an active exception". + * + * This has happened in this scenario: A background thread is running + * a greenlet that has made a native call and released the GIL. + * Meanwhile, the main thread finishes and starts shutting down the + * interpreter. When the background thread is scheduled again and + * attempts to obtain the GIL, it notices that the interpreter is + * exiting and calls ``pthread_exit()``. This in turn starts to unwind + * the stack by throwing that exception. But we had the ``PyCall`` + * functions annotated as noexcept, so the runtime terminated us. + * + * #2 0x00007fab26fec2b7 in std::terminate() () from /lib/x86_64-linux-gnu/libstdc++.so.6 + * #3 0x00007fab26febb3c in __gxx_personality_v0 () from /lib/x86_64-linux-gnu/libstdc++.so.6 + * #4 0x00007fab26f34de6 in ?? () from /lib/x86_64-linux-gnu/libgcc_s.so.1 + * #6 0x00007fab276a34c6 in __GI___pthread_unwind at ./nptl/unwind.c:130 + * #7 0x00007fab2769bd3a in __do_cancel () at ../sysdeps/nptl/pthreadP.h:280 + * #8 __GI___pthread_exit (value=value@entry=0x0) at ./nptl/pthread_exit.c:36 + * #9 0x000000000052e567 in PyThread_exit_thread () at ../Python/thread_pthread.h:370 + * #10 0x00000000004d60b5 in take_gil at ../Python/ceval_gil.h:224 + * #11 0x00000000004d65f9 in PyEval_RestoreThread at ../Python/ceval.c:467 + * #12 0x000000000060cce3 in setipaddr at ../Modules/socketmodule.c:1203 + * #13 0x00000000006101cd in socket_gethostbyname + */ + +#include + +# define G_NO_COPIES_OF_CLS(Cls) private: \ + Cls(const Cls& other) = delete; \ + Cls& operator=(const Cls& other) = delete + +# define G_NO_ASSIGNMENT_OF_CLS(Cls) private: \ + Cls& operator=(const Cls& other) = delete + +# define G_NO_COPY_CONSTRUCTOR_OF_CLS(Cls) private: \ + Cls(const Cls& other) = delete; + + +// CAUTION: MSVC is stupidly picky: +// +// "The compiler ignores, without warning, any __declspec keywords +// placed after * or & and in front of the variable identifier in a +// declaration." +// (https://docs.microsoft.com/en-us/cpp/cpp/declspec?view=msvc-160) +// +// So pointer return types must be handled differently (because of the +// trailing *), or you get inscrutable compiler warnings like "error +// C2059: syntax error: ''" +// +// In C++ 11, there is a standard syntax for attributes, and +// GCC defines an attribute to use with this: [[gnu:noinline]]. +// In the future, this is expected to become standard. + +#if defined(__GNUC__) || defined(__clang__) +/* We used to check for GCC 4+ or 3.4+, but those compilers are + laughably out of date. Just assume they support it. */ +# define GREENLET_NOINLINE(name) __attribute__((noinline)) name +# define GREENLET_NOINLINE_P(rtype, name) rtype __attribute__((noinline)) name +# define UNUSED(x) UNUSED_ ## x __attribute__((__unused__)) +#elif defined(_MSC_VER) +/* We used to check for && (_MSC_VER >= 1300) but that's also out of date. */ +# define GREENLET_NOINLINE(name) __declspec(noinline) name +# define GREENLET_NOINLINE_P(rtype, name) __declspec(noinline) rtype name +# define UNUSED(x) UNUSED_ ## x +#endif + +#if defined(_MSC_VER) +# define G_NOEXCEPT_WIN32 noexcept +#else +# define G_NOEXCEPT_WIN32 +#endif + +#if defined(__GNUC__) && defined(__POWERPC__) && defined(__APPLE__) +// 32-bit PPC/MacOSX. Only known to be tested on unreleased versions +// of macOS 10.6 using a macports build gcc 14. It appears that +// running C++ destructors of thread-local variables is broken. + +// See https://github.com/python-greenlet/greenlet/pull/419 +# define GREENLET_BROKEN_THREAD_LOCAL_CLEANUP_JUST_LEAK 1 +#else +# define GREENLET_BROKEN_THREAD_LOCAL_CLEANUP_JUST_LEAK 0 +#endif + + +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp b/.venv/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp new file mode 100644 index 0000000..0d28efd --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_cpython_add_pending.hpp @@ -0,0 +1,172 @@ +#ifndef GREENLET_CPYTHON_ADD_PENDING_HPP +#define GREENLET_CPYTHON_ADD_PENDING_HPP + +#if (PY_VERSION_HEX >= 0x30800A0 && PY_VERSION_HEX < 0x3090000) && !(defined(_WIN32) || defined(WIN32)) +// XXX: From Python 3.8a3 [1] up until Python 3.9a6 [2][3], +// ``Py_AddPendingCall`` would try to produce a Python exception if +// the interpreter was in the beginning of shutting down when this +// function is called. However, ``Py_AddPendingCall`` doesn't require +// the GIL, and we are absolutely not holding it when we make that +// call. That means that trying to create the Python exception is +// using the C API in an undefined state; here the C API detects this +// and aborts the process with an error ("Fatal Python error: Python +// memory allocator called without holding the GIL": Add -> +// PyErr_SetString -> PyUnicode_New -> PyObject_Malloc). This arises +// (obviously) in multi-threaded programs and happens if one thread is +// exiting and cleaning up its thread-local data while the other +// thread is trying to shut down the interpreter. A crash on shutdown +// is still a crash and could result in data loss (e.g., daemon +// threads are still running, pending signal handlers may be present, +// buffers may not be flushed, there may be __del__ that need run, +// etc), so we have to work around it. +// +// Of course, we can (and do) check for whether the interpreter is +// shutting down before calling ``Py_AddPendingCall``, but that's a +// race condition since we don't hold the GIL, and so we may not +// actually get the right answer. Plus, ``Py_FinalizeEx`` actually +// calls ``_Py_FinishPendingCalls`` (which sets the pending->finishing +// flag, which is used to gate creating the exceptioen) *before* +// publishing any other data that would let us detect the shutdown +// (such as runtime->finalizing). So that point is moot. +// +// Our solution for those versions is to inline the same code, without +// the problematic bit that sets the exception. Unfortunately, all of +// the structure definitions are private/opaque, *and* we can't +// actually count on being able to include their definitions from +// ``internal/pycore_*``, because on some platforms those header files +// are incomplete (i.e., on macOS with macports 3.8, the includes are +// fine, but on Ubuntu jammy with 3.8 from ppa:deadsnakes or GitHub +// Actions 3.8 (I think it's Ubuntu 18.04), they con't be used; at +// least, I couldn't get them to work). So we need to define the +// structures and _PyRuntime data member ourself. Yet more +// unfortunately, _PyRuntime won't link on Windows, so we can only do +// this on other platforms. +// +// [1] https://github.com/python/cpython/commit/842a2f07f2f08a935ef470bfdaeef40f87490cfc +// [2] https://github.com/python/cpython/commit/cfc3c2f8b34d3864717ab584c5b6c260014ba55a +// [3] https://github.com/python/cpython/issues/81308 +# define GREENLET_BROKEN_PY_ADD_PENDING 1 + +// When defining these structures, the important thing is to get +// binary compatibility, i.e., structure layout. For that, we only +// need to define fields up to the ones we use; after that they're +// irrelevant UNLESS the structure is included in another structure +// *before* the structure we're interested in --- in that case, it +// must be complete. Ellipsis indicate elided trailing members. +// Pointer types are changed to void* to keep from having to define +// more structures. + +// From "internal/pycore_atomic.h" + +// There are several different definitions of this, including the +// plain ``int`` version, a ``volatile int`` and an ``_Atomic int`` +// I don't think any of those change the size/layout. +typedef struct _Py_atomic_int { + volatile int _value; +} _Py_atomic_int; + +// This needs too much infrastructure, so we just do a regular store. +#define _Py_atomic_store_relaxed(ATOMIC_VAL, NEW_VAL) \ + (ATOMIC_VAL)->_value = NEW_VAL + + + +// From "internal/pycore_pymem.h" +#define NUM_GENERATIONS 3 + + +struct gc_generation { + PyGC_Head head; // We already have this defined. + int threshold; + int count; +}; +struct gc_generation_stats { + Py_ssize_t collections; + Py_ssize_t collected; + Py_ssize_t uncollectable; +}; + +struct _gc_runtime_state { + void *trash_delete_later; + int trash_delete_nesting; + int enabled; + int debug; + struct gc_generation generations[NUM_GENERATIONS]; + void *generation0; + struct gc_generation permanent_generation; + struct gc_generation_stats generation_stats[NUM_GENERATIONS]; + int collecting; + void *garbage; + void *callbacks; + Py_ssize_t long_lived_total; + Py_ssize_t long_lived_pending; +}; + +// From "internal/pycore_pystate.h" +struct _pending_calls { + int finishing; + PyThread_type_lock lock; + _Py_atomic_int calls_to_do; + int async_exc; +#define NPENDINGCALLS 32 + struct { + int (*func)(void *); + void *arg; + } calls[NPENDINGCALLS]; + int first; + int last; +}; + +struct _ceval_runtime_state { + int recursion_limit; + int tracing_possible; + _Py_atomic_int eval_breaker; + _Py_atomic_int gil_drop_request; + struct _pending_calls pending; + // ... +}; + +typedef struct pyruntimestate { + int preinitializing; + int preinitialized; + int core_initialized; + int initialized; + void *finalizing; + + struct pyinterpreters { + PyThread_type_lock mutex; + void *head; + void *main; + int64_t next_id; + } interpreters; + // XXX Remove this field once we have a tp_* slot. + struct _xidregistry { + PyThread_type_lock mutex; + void *head; + } xidregistry; + + unsigned long main_thread; + +#define NEXITFUNCS 32 + void (*exitfuncs[NEXITFUNCS])(void); + int nexitfuncs; + + struct _gc_runtime_state gc; + struct _ceval_runtime_state ceval; + // ... +} _PyRuntimeState; + +#define SIGNAL_PENDING_CALLS(ceval) \ + do { \ + _Py_atomic_store_relaxed(&(ceval)->pending.calls_to_do, 1); \ + _Py_atomic_store_relaxed(&(ceval)->eval_breaker, 1); \ + } while (0) + +extern _PyRuntimeState _PyRuntime; + +#else +# define GREENLET_BROKEN_PY_ADD_PENDING 0 +#endif + + +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp b/.venv/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp new file mode 100644 index 0000000..ce5fd88 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_cpython_compat.hpp @@ -0,0 +1,142 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +#ifndef GREENLET_CPYTHON_COMPAT_H +#define GREENLET_CPYTHON_COMPAT_H + +/** + * Helpers for compatibility with multiple versions of CPython. + */ + +#define PY_SSIZE_T_CLEAN +#include "Python.h" + + +#if PY_VERSION_HEX >= 0x30A00B1 +# define GREENLET_PY310 1 +#else +# define GREENLET_PY310 0 +#endif + +/* +Python 3.10 beta 1 changed tstate->use_tracing to a nested cframe member. +See https://github.com/python/cpython/pull/25276 +We have to save and restore this as well. + +Python 3.13 removed PyThreadState.cframe (GH-108035). +*/ +#if GREENLET_PY310 && PY_VERSION_HEX < 0x30D0000 +# define GREENLET_USE_CFRAME 1 +#else +# define GREENLET_USE_CFRAME 0 +#endif + + +#if PY_VERSION_HEX >= 0x30B00A4 +/* +Greenlet won't compile on anything older than Python 3.11 alpha 4 (see +https://bugs.python.org/issue46090). Summary of breaking internal changes: +- Python 3.11 alpha 1 changed how frame objects are represented internally. + - https://github.com/python/cpython/pull/30122 +- Python 3.11 alpha 3 changed how recursion limits are stored. + - https://github.com/python/cpython/pull/29524 +- Python 3.11 alpha 4 changed how exception state is stored. It also includes a + change to help greenlet save and restore the interpreter frame "data stack". + - https://github.com/python/cpython/pull/30122 + - https://github.com/python/cpython/pull/30234 +*/ +# define GREENLET_PY311 1 +#else +# define GREENLET_PY311 0 +#endif + + +#if PY_VERSION_HEX >= 0x30C0000 +# define GREENLET_PY312 1 +#else +# define GREENLET_PY312 0 +#endif + +#if PY_VERSION_HEX >= 0x30D0000 +# define GREENLET_PY313 1 +#else +# define GREENLET_PY313 0 +#endif + +#ifndef Py_SET_REFCNT +/* Py_REFCNT and Py_SIZE macros are converted to functions +https://bugs.python.org/issue39573 */ +# define Py_SET_REFCNT(obj, refcnt) Py_REFCNT(obj) = (refcnt) +#endif + +#ifndef _Py_DEC_REFTOTAL +/* _Py_DEC_REFTOTAL macro has been removed from Python 3.9 by: + https://github.com/python/cpython/commit/49932fec62c616ec88da52642339d83ae719e924 + + The symbol we use to replace it was removed by at least 3.12. +*/ +# ifdef Py_REF_DEBUG +# if GREENLET_PY312 +# define _Py_DEC_REFTOTAL +# else +# define _Py_DEC_REFTOTAL _Py_RefTotal-- +# endif +# else +# define _Py_DEC_REFTOTAL +# endif +#endif +// Define these flags like Cython does if we're on an old version. +#ifndef Py_TPFLAGS_CHECKTYPES + #define Py_TPFLAGS_CHECKTYPES 0 +#endif +#ifndef Py_TPFLAGS_HAVE_INDEX + #define Py_TPFLAGS_HAVE_INDEX 0 +#endif +#ifndef Py_TPFLAGS_HAVE_NEWBUFFER + #define Py_TPFLAGS_HAVE_NEWBUFFER 0 +#endif + +#ifndef Py_TPFLAGS_HAVE_VERSION_TAG + #define Py_TPFLAGS_HAVE_VERSION_TAG 0 +#endif + +#define G_TPFLAGS_DEFAULT Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_VERSION_TAG | Py_TPFLAGS_CHECKTYPES | Py_TPFLAGS_HAVE_NEWBUFFER | Py_TPFLAGS_HAVE_GC + + +#if PY_VERSION_HEX < 0x03090000 +// The official version only became available in 3.9 +# define PyObject_GC_IsTracked(o) _PyObject_GC_IS_TRACKED(o) +#endif + + +// bpo-43760 added PyThreadState_EnterTracing() to Python 3.11.0a2 +#if PY_VERSION_HEX < 0x030B00A2 && !defined(PYPY_VERSION) +static inline void PyThreadState_EnterTracing(PyThreadState *tstate) +{ + tstate->tracing++; +#if PY_VERSION_HEX >= 0x030A00A1 + tstate->cframe->use_tracing = 0; +#else + tstate->use_tracing = 0; +#endif +} +#endif + +// bpo-43760 added PyThreadState_LeaveTracing() to Python 3.11.0a2 +#if PY_VERSION_HEX < 0x030B00A2 && !defined(PYPY_VERSION) +static inline void PyThreadState_LeaveTracing(PyThreadState *tstate) +{ + tstate->tracing--; + int use_tracing = (tstate->c_tracefunc != NULL + || tstate->c_profilefunc != NULL); +#if PY_VERSION_HEX >= 0x030A00A1 + tstate->cframe->use_tracing = use_tracing; +#else + tstate->use_tracing = use_tracing; +#endif +} +#endif + +#if !defined(Py_C_RECURSION_LIMIT) && defined(C_RECURSION_LIMIT) +# define Py_C_RECURSION_LIMIT C_RECURSION_LIMIT +#endif + +#endif /* GREENLET_CPYTHON_COMPAT_H */ diff --git a/.venv/Lib/site-packages/greenlet/greenlet_exceptions.hpp b/.venv/Lib/site-packages/greenlet/greenlet_exceptions.hpp new file mode 100644 index 0000000..617f07c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_exceptions.hpp @@ -0,0 +1,171 @@ +#ifndef GREENLET_EXCEPTIONS_HPP +#define GREENLET_EXCEPTIONS_HPP + +#define PY_SSIZE_T_CLEAN +#include +#include +#include + +#ifdef __clang__ +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wunused-function" +#endif + +namespace greenlet { + + class PyErrOccurred : public std::runtime_error + { + public: + + // CAUTION: In debug builds, may run arbitrary Python code. + static const PyErrOccurred + from_current() + { + assert(PyErr_Occurred()); +#ifndef NDEBUG + // This is not exception safe, and + // not necessarily safe in general (what if it switches?) + // But we only do this in debug mode, where we are in + // tight control of what exceptions are getting raised and + // can prevent those issues. + + // You can't call PyObject_Str with a pending exception. + PyObject* typ; + PyObject* val; + PyObject* tb; + + PyErr_Fetch(&typ, &val, &tb); + PyObject* typs = PyObject_Str(typ); + PyObject* vals = PyObject_Str(val ? val : typ); + const char* typ_msg = PyUnicode_AsUTF8(typs); + const char* val_msg = PyUnicode_AsUTF8(vals); + PyErr_Restore(typ, val, tb); + + std::string msg(typ_msg); + msg += ": "; + msg += val_msg; + PyErrOccurred ex(msg); + Py_XDECREF(typs); + Py_XDECREF(vals); + + return ex; +#else + return PyErrOccurred(); +#endif + } + + PyErrOccurred() : std::runtime_error("") + { + assert(PyErr_Occurred()); + } + + PyErrOccurred(const std::string& msg) : std::runtime_error(msg) + { + assert(PyErr_Occurred()); + } + + PyErrOccurred(PyObject* exc_kind, const char* const msg) + : std::runtime_error(msg) + { + PyErr_SetString(exc_kind, msg); + } + + PyErrOccurred(PyObject* exc_kind, const std::string msg) + : std::runtime_error(msg) + { + // This copies the c_str, so we don't have any lifetime + // issues to worry about. + PyErr_SetString(exc_kind, msg.c_str()); + } + + PyErrOccurred(PyObject* exc_kind, + const std::string msg, //This is the format + //string; that's not + //usually safe! + + PyObject* borrowed_obj_one, PyObject* borrowed_obj_two) + : std::runtime_error(msg) + { + + //This is designed specifically for the + //``check_switch_allowed`` function. + + // PyObject_Str and PyObject_Repr are safe to call with + // NULL pointers; they return the string "" in that + // case. + // This function always returns null. + PyErr_Format(exc_kind, + msg.c_str(), + borrowed_obj_one, borrowed_obj_two); + } + }; + + class TypeError : public PyErrOccurred + { + public: + TypeError(const char* const what) + : PyErrOccurred(PyExc_TypeError, what) + { + } + TypeError(const std::string what) + : PyErrOccurred(PyExc_TypeError, what) + { + } + }; + + class ValueError : public PyErrOccurred + { + public: + ValueError(const char* const what) + : PyErrOccurred(PyExc_ValueError, what) + { + } + }; + + class AttributeError : public PyErrOccurred + { + public: + AttributeError(const char* const what) + : PyErrOccurred(PyExc_AttributeError, what) + { + } + }; + + /** + * Calls `Py_FatalError` when constructed, so you can't actually + * throw this. It just makes static analysis easier. + */ + class PyFatalError : public std::runtime_error + { + public: + PyFatalError(const char* const msg) + : std::runtime_error(msg) + { + Py_FatalError(msg); + } + }; + + static inline PyObject* + Require(PyObject* p, const std::string& msg="") + { + if (!p) { + throw PyErrOccurred(msg); + } + return p; + }; + + static inline void + Require(const int retval) + { + if (retval < 0) { + throw PyErrOccurred(); + } + }; + + +}; +#ifdef __clang__ +# pragma clang diagnostic pop +#endif + +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet_internal.hpp b/.venv/Lib/site-packages/greenlet/greenlet_internal.hpp new file mode 100644 index 0000000..f2b15d5 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_internal.hpp @@ -0,0 +1,107 @@ +/* -*- indent-tabs-mode: nil; tab-width: 4; -*- */ +#ifndef GREENLET_INTERNAL_H +#define GREENLET_INTERNAL_H +#ifdef __clang__ +# pragma clang diagnostic push +# pragma clang diagnostic ignored "-Wunused-function" +#endif + +/** + * Implementation helpers. + * + * C++ templates and inline functions should go here. + */ +#define PY_SSIZE_T_CLEAN +#include "greenlet_compiler_compat.hpp" +#include "greenlet_cpython_compat.hpp" +#include "greenlet_exceptions.hpp" +#include "TGreenlet.hpp" +#include "greenlet_allocator.hpp" + +#include +#include + +#define GREENLET_MODULE +struct _greenlet; +typedef struct _greenlet PyGreenlet; +namespace greenlet { + + class ThreadState; + // We can't use the PythonAllocator for this, because we push to it + // from the thread state destructor, which doesn't have the GIL, + // and Python's allocators can only be called with the GIL. + typedef std::vector cleanup_queue_t; + +}; + + +#define implementation_ptr_t greenlet::Greenlet* + + +#include "greenlet.h" + +void +greenlet::refs::MainGreenletExactChecker(void *p) +{ + if (!p) { + return; + } + // We control the class of the main greenlet exactly. + if (Py_TYPE(p) != &PyGreenlet_Type) { + std::string err("MainGreenlet: Expected exactly a greenlet, not a "); + err += Py_TYPE(p)->tp_name; + throw greenlet::TypeError(err); + } + + // Greenlets from dead threads no longer respond to main() with a + // true value; so in that case we need to perform an additional + // check. + Greenlet* g = static_cast(p)->pimpl; + if (g->main()) { + return; + } + if (!dynamic_cast(g)) { + std::string err("MainGreenlet: Expected exactly a main greenlet, not a "); + err += Py_TYPE(p)->tp_name; + throw greenlet::TypeError(err); + } +} + + + +template +inline greenlet::Greenlet* greenlet::refs::_OwnedGreenlet::operator->() const noexcept +{ + return reinterpret_cast(this->p)->pimpl; +} + +template +inline greenlet::Greenlet* greenlet::refs::_BorrowedGreenlet::operator->() const noexcept +{ + return reinterpret_cast(this->p)->pimpl; +} + +#include +#include + + +extern PyTypeObject PyGreenlet_Type; + + + +/** + * Forward declarations needed in multiple files. + */ +static PyObject* green_switch(PyGreenlet* self, PyObject* args, PyObject* kwargs); + + +#ifdef __clang__ +# pragma clang diagnostic pop +#endif + + +#endif + +// Local Variables: +// flycheck-clang-include-path: ("../../include" "/opt/local/Library/Frameworks/Python.framework/Versions/3.10/include/python3.10") +// End: diff --git a/.venv/Lib/site-packages/greenlet/greenlet_refs.hpp b/.venv/Lib/site-packages/greenlet/greenlet_refs.hpp new file mode 100644 index 0000000..b7e5e3f --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_refs.hpp @@ -0,0 +1,1118 @@ +#ifndef GREENLET_REFS_HPP +#define GREENLET_REFS_HPP + +#define PY_SSIZE_T_CLEAN +#include + +#include + +//#include "greenlet_internal.hpp" +#include "greenlet_compiler_compat.hpp" +#include "greenlet_cpython_compat.hpp" +#include "greenlet_exceptions.hpp" + +struct _greenlet; +struct _PyMainGreenlet; + +typedef struct _greenlet PyGreenlet; +extern PyTypeObject PyGreenlet_Type; + + +#ifdef GREENLET_USE_STDIO +#include +using std::cerr; +using std::endl; +#endif + +namespace greenlet +{ + class Greenlet; + + namespace refs + { + // Type checkers throw a TypeError if the argument is not + // null, and isn't of the required Python type. + // (We can't use most of the defined type checkers + // like PyList_Check, etc, directly, because they are + // implemented as macros.) + typedef void (*TypeChecker)(void*); + + void + NoOpChecker(void*) + { + return; + } + + void + GreenletChecker(void *p) + { + if (!p) { + return; + } + + PyTypeObject* typ = Py_TYPE(p); + // fast, common path. (PyObject_TypeCheck is a macro or + // static inline function, and it also does a + // direct comparison of the type pointers, but its fast + // path only handles one type) + if (typ == &PyGreenlet_Type) { + return; + } + + if (!PyObject_TypeCheck(p, &PyGreenlet_Type)) { + std::string err("GreenletChecker: Expected any type of greenlet, not "); + err += Py_TYPE(p)->tp_name; + throw TypeError(err); + } + } + + void + MainGreenletExactChecker(void *p); + + template + class PyObjectPointer; + + template + class OwnedReference; + + + template + class BorrowedReference; + + typedef BorrowedReference BorrowedObject; + typedef OwnedReference OwnedObject; + + class ImmortalObject; + class ImmortalString; + + template + class _OwnedGreenlet; + + typedef _OwnedGreenlet OwnedGreenlet; + typedef _OwnedGreenlet OwnedMainGreenlet; + + template + class _BorrowedGreenlet; + + typedef _BorrowedGreenlet BorrowedGreenlet; + + void + ContextExactChecker(void *p) + { + if (!p) { + return; + } + if (!PyContext_CheckExact(p)) { + throw TypeError( + "greenlet context must be a contextvars.Context or None" + ); + } + } + + typedef OwnedReference OwnedContext; + } +} + +namespace greenlet { + + + namespace refs { + // A set of classes to make reference counting rules in python + // code explicit. + // + // Rules of use: + // (1) Functions returning a new reference that the caller of the + // function is expected to dispose of should return a + // ``OwnedObject`` object. This object automatically releases its + // reference when it goes out of scope. It works like a ``std::shared_ptr`` + // and can be copied or used as a function parameter (but don't do + // that). Note that constructing a ``OwnedObject`` from a + // PyObject* steals the reference. + // (2) Parameters to functions should be either a + // ``OwnedObject&``, or, more generally, a ``PyObjectPointer&``. + // If the function needs to create its own new reference, it can + // do so by copying to a local ``OwnedObject``. + // (3) Functions returning an existing pointer that is NOT + // incref'd, and which the caller MUST NOT decref, + // should return a ``BorrowedObject``. + + // XXX: The following two paragraphs do not hold for all platforms. + // Notably, 32-bit PPC Linux passes structs by reference, not by + // value, so this actually doesn't work. (Although that's the only + // platform that doesn't work on.) DO NOT ATTEMPT IT. The + // unfortunate consequence of that is that the slots which we + // *know* are already type safe will wind up calling the type + // checker function (when we had the slots accepting + // BorrowedGreenlet, this was bypassed), so this slows us down. + // TODO: Optimize this again. + + // For a class with a single pointer member, whose constructor + // does nothing but copy a pointer parameter into the member, and + // which can then be converted back to the pointer type, compilers + // generate code that's the same as just passing the pointer. + // That is, func(BorrowedObject x) called like ``PyObject* p = + // ...; f(p)`` has 0 overhead. Similarly, they "unpack" to the + // pointer type with 0 overhead. + // + // If there are no virtual functions, no complex inheritance (maybe?) and + // no destructor, these can be directly used as parameters in + // Python callbacks like tp_init: the layout is the same as a + // single pointer. Only subclasses with trivial constructors that + // do nothing but set the single pointer member are safe to use + // that way. + + + // This is the base class for things that can be done with a + // PyObject pointer. It assumes nothing about memory management. + // NOTE: Nothing is virtual, so subclasses shouldn't add new + // storage fields or try to override these methods. + template + class PyObjectPointer + { + public: + typedef T PyType; + protected: + T* p; + public: + PyObjectPointer(T* it=nullptr) : p(it) + { + TC(p); + } + + // We don't allow automatic casting to PyObject* at this + // level, because then we could be passed to Py_DECREF/INCREF, + // but we want nothing to do with memory management. If you + // know better, then you can use the get() method, like on a + // std::shared_ptr. Except we name it borrow() to clarify that + // if this is a reference-tracked object, the pointer you get + // back will go away when the object does. + // TODO: This should probably not exist here, but be moved + // down to relevant sub-types. + + T* borrow() const noexcept + { + return this->p; + } + + PyObject* borrow_o() const noexcept + { + return reinterpret_cast(this->p); + } + + T* operator->() const noexcept + { + return this->p; + } + + bool is_None() const noexcept + { + return this->p == Py_None; + } + + PyObject* acquire_or_None() const noexcept + { + PyObject* result = this->p ? reinterpret_cast(this->p) : Py_None; + Py_INCREF(result); + return result; + } + + explicit operator bool() const noexcept + { + return this->p != nullptr; + } + + bool operator!() const noexcept + { + return this->p == nullptr; + } + + Py_ssize_t REFCNT() const noexcept + { + return p ? Py_REFCNT(p) : -42; + } + + PyTypeObject* TYPE() const noexcept + { + return p ? Py_TYPE(p) : nullptr; + } + + inline OwnedObject PyStr() const noexcept; + inline const std::string as_str() const noexcept; + inline OwnedObject PyGetAttr(const ImmortalObject& name) const noexcept; + inline OwnedObject PyRequireAttr(const char* const name) const; + inline OwnedObject PyRequireAttr(const ImmortalString& name) const; + inline OwnedObject PyCall(const BorrowedObject& arg) const; + inline OwnedObject PyCall(PyGreenlet* arg) const ; + inline OwnedObject PyCall(PyObject* arg) const ; + // PyObject_Call(this, args, kwargs); + inline OwnedObject PyCall(const BorrowedObject args, + const BorrowedObject kwargs) const; + inline OwnedObject PyCall(const OwnedObject& args, + const OwnedObject& kwargs) const; + + protected: + void _set_raw_pointer(void* t) + { + TC(t); + p = reinterpret_cast(t); + } + void* _get_raw_pointer() const + { + return p; + } + }; + +#ifdef GREENLET_USE_STDIO + template + std::ostream& operator<<(std::ostream& os, const PyObjectPointer& s) + { + const std::type_info& t = typeid(s); + os << t.name() + << "(addr=" << s.borrow() + << ", refcnt=" << s.REFCNT() + << ", value=" << s.as_str() + << ")"; + + return os; + } +#endif + + template + inline bool operator==(const PyObjectPointer& lhs, const PyObject* const rhs) noexcept + { + return static_cast(lhs.borrow_o()) == static_cast(rhs); + } + + template + inline bool operator==(const PyObjectPointer& lhs, const PyObjectPointer& rhs) noexcept + { + return lhs.borrow_o() == rhs.borrow_o(); + } + + template + inline bool operator!=(const PyObjectPointer& lhs, + const PyObjectPointer& rhs) noexcept + { + return lhs.borrow_o() != rhs.borrow_o(); + } + + template + class OwnedReference : public PyObjectPointer + { + private: + friend class OwnedList; + + protected: + explicit OwnedReference(T* it) : PyObjectPointer(it) + { + } + + public: + + // Constructors + + static OwnedReference consuming(PyObject* p) + { + return OwnedReference(reinterpret_cast(p)); + } + + static OwnedReference owning(T* p) + { + OwnedReference result(p); + Py_XINCREF(result.p); + return result; + } + + OwnedReference() : PyObjectPointer(nullptr) + {} + + explicit OwnedReference(const PyObjectPointer<>& other) + : PyObjectPointer(nullptr) + { + T* op = other.borrow(); + TC(op); + this->p = other.borrow(); + Py_XINCREF(this->p); + } + + // It would be good to make use of the C++11 distinction + // between move and copy operations, e.g., constructing from a + // pointer should be a move operation. + // In the common case of ``OwnedObject x = Py_SomeFunction()``, + // the call to the copy constructor will be elided completely. + OwnedReference(const OwnedReference& other) + : PyObjectPointer(other.p) + { + Py_XINCREF(this->p); + } + + static OwnedReference None() + { + Py_INCREF(Py_None); + return OwnedReference(Py_None); + } + + // We can assign from exactly our type without any extra checking + OwnedReference& operator=(const OwnedReference& other) + { + Py_XINCREF(other.p); + const T* tmp = this->p; + this->p = other.p; + Py_XDECREF(tmp); + return *this; + } + + OwnedReference& operator=(const BorrowedReference other) + { + return this->operator=(other.borrow()); + } + + OwnedReference& operator=(T* const other) + { + TC(other); + Py_XINCREF(other); + T* tmp = this->p; + this->p = other; + Py_XDECREF(tmp); + return *this; + } + + // We can assign from an arbitrary reference type + // if it passes our check. + template + OwnedReference& operator=(const OwnedReference& other) + { + X* op = other.borrow(); + TC(op); + return this->operator=(reinterpret_cast(op)); + } + + inline void steal(T* other) + { + assert(this->p == nullptr); + TC(other); + this->p = other; + } + + T* relinquish_ownership() + { + T* result = this->p; + this->p = nullptr; + return result; + } + + T* acquire() const + { + // Return a new reference. + // TODO: This may go away when we have reference objects + // throughout the code. + Py_XINCREF(this->p); + return this->p; + } + + // Nothing else declares a destructor, we're the leaf, so we + // should be able to get away without virtual. + ~OwnedReference() + { + Py_CLEAR(this->p); + } + + void CLEAR() + { + Py_CLEAR(this->p); + assert(this->p == nullptr); + } + }; + + static inline + void operator<<=(PyObject*& target, OwnedObject& o) + { + target = o.relinquish_ownership(); + } + + + class NewReference : public OwnedObject + { + private: + G_NO_COPIES_OF_CLS(NewReference); + public: + // Consumes the reference. Only use this + // for API return values. + NewReference(PyObject* it) : OwnedObject(it) + { + } + }; + + class NewDictReference : public NewReference + { + private: + G_NO_COPIES_OF_CLS(NewDictReference); + public: + NewDictReference() : NewReference(PyDict_New()) + { + if (!this->p) { + throw PyErrOccurred(); + } + } + + void SetItem(const char* const key, PyObject* value) + { + Require(PyDict_SetItemString(this->p, key, value)); + } + + void SetItem(const PyObjectPointer<>& key, PyObject* value) + { + Require(PyDict_SetItem(this->p, key.borrow_o(), value)); + } + }; + + template + class _OwnedGreenlet: public OwnedReference + { + private: + protected: + _OwnedGreenlet(T* it) : OwnedReference(it) + {} + + public: + _OwnedGreenlet() : OwnedReference() + {} + + _OwnedGreenlet(const _OwnedGreenlet& other) : OwnedReference(other) + { + } + _OwnedGreenlet(OwnedMainGreenlet& other) : + OwnedReference(reinterpret_cast(other.acquire())) + { + } + _OwnedGreenlet(const BorrowedGreenlet& other); + // Steals a reference. + static _OwnedGreenlet consuming(PyGreenlet* it) + { + return _OwnedGreenlet(reinterpret_cast(it)); + } + + inline _OwnedGreenlet& operator=(const OwnedGreenlet& other) + { + return this->operator=(other.borrow()); + } + + inline _OwnedGreenlet& operator=(const BorrowedGreenlet& other); + + _OwnedGreenlet& operator=(const OwnedMainGreenlet& other) + { + PyGreenlet* owned = other.acquire(); + Py_XDECREF(this->p); + this->p = reinterpret_cast(owned); + return *this; + } + + _OwnedGreenlet& operator=(T* const other) + { + OwnedReference::operator=(other); + return *this; + } + + T* relinquish_ownership() + { + T* result = this->p; + this->p = nullptr; + return result; + } + + PyObject* relinquish_ownership_o() + { + return reinterpret_cast(relinquish_ownership()); + } + + inline Greenlet* operator->() const noexcept; + inline operator Greenlet*() const noexcept; + }; + + template + class BorrowedReference : public PyObjectPointer + { + public: + // Allow implicit creation from PyObject* pointers as we + // transition to using these classes. Also allow automatic + // conversion to PyObject* for passing to C API calls and even + // for Py_INCREF/DECREF, because we ourselves do no memory management. + BorrowedReference(T* it) : PyObjectPointer(it) + {} + + BorrowedReference(const PyObjectPointer& ref) : PyObjectPointer(ref.borrow()) + {} + + BorrowedReference() : PyObjectPointer(nullptr) + {} + + operator T*() const + { + return this->p; + } + }; + + typedef BorrowedReference BorrowedObject; + //typedef BorrowedReference BorrowedGreenlet; + + template + class _BorrowedGreenlet : public BorrowedReference + { + public: + _BorrowedGreenlet() : + BorrowedReference(nullptr) + {} + + _BorrowedGreenlet(T* it) : + BorrowedReference(it) + {} + + _BorrowedGreenlet(const BorrowedObject& it); + + _BorrowedGreenlet(const OwnedGreenlet& it) : + BorrowedReference(it.borrow()) + {} + + _BorrowedGreenlet& operator=(const BorrowedObject& other); + + // We get one of these for PyGreenlet, but one for PyObject + // is handy as well + operator PyObject*() const + { + return reinterpret_cast(this->p); + } + Greenlet* operator->() const noexcept; + operator Greenlet*() const noexcept; + }; + + typedef _BorrowedGreenlet BorrowedGreenlet; + + template + _OwnedGreenlet::_OwnedGreenlet(const BorrowedGreenlet& other) + : OwnedReference(reinterpret_cast(other.borrow())) + { + Py_XINCREF(this->p); + } + + + class BorrowedMainGreenlet + : public _BorrowedGreenlet + { + public: + BorrowedMainGreenlet(const OwnedMainGreenlet& it) : + _BorrowedGreenlet(it.borrow()) + {} + BorrowedMainGreenlet(PyGreenlet* it=nullptr) + : _BorrowedGreenlet(it) + {} + }; + + template + _OwnedGreenlet& _OwnedGreenlet::operator=(const BorrowedGreenlet& other) + { + return this->operator=(other.borrow()); + } + + + class ImmortalObject : public PyObjectPointer<> + { + private: + G_NO_ASSIGNMENT_OF_CLS(ImmortalObject); + public: + explicit ImmortalObject(PyObject* it) : PyObjectPointer<>(it) + { + } + + ImmortalObject(const ImmortalObject& other) + : PyObjectPointer<>(other.p) + { + + } + + /** + * Become the new owner of the object. Does not change the + * reference count. + */ + ImmortalObject& operator=(PyObject* it) + { + assert(this->p == nullptr); + this->p = it; + return *this; + } + + static ImmortalObject consuming(PyObject* it) + { + return ImmortalObject(it); + } + + inline operator PyObject*() const + { + return this->p; + } + }; + + class ImmortalString : public ImmortalObject + { + private: + G_NO_COPIES_OF_CLS(ImmortalString); + const char* str; + public: + ImmortalString(const char* const str) : + ImmortalObject(str ? Require(PyUnicode_InternFromString(str)) : nullptr) + { + this->str = str; + } + + inline ImmortalString& operator=(const char* const str) + { + if (!this->p) { + this->p = Require(PyUnicode_InternFromString(str)); + this->str = str; + } + else { + assert(this->str == str); + } + return *this; + } + + inline operator std::string() const + { + return this->str; + } + + }; + + class ImmortalEventName : public ImmortalString + { + private: + G_NO_COPIES_OF_CLS(ImmortalEventName); + public: + ImmortalEventName(const char* const str) : ImmortalString(str) + {} + }; + + class ImmortalException : public ImmortalObject + { + private: + G_NO_COPIES_OF_CLS(ImmortalException); + public: + ImmortalException(const char* const name, PyObject* base=nullptr) : + ImmortalObject(name + // Python 2.7 isn't const correct + ? Require(PyErr_NewException((char*)name, base, nullptr)) + : nullptr) + {} + + inline bool PyExceptionMatches() const + { + return PyErr_ExceptionMatches(this->p) > 0; + } + + }; + + template + inline OwnedObject PyObjectPointer::PyStr() const noexcept + { + if (!this->p) { + return OwnedObject(); + } + return OwnedObject::consuming(PyObject_Str(reinterpret_cast(this->p))); + } + + template + inline const std::string PyObjectPointer::as_str() const noexcept + { + // NOTE: This is not Python exception safe. + if (this->p) { + // The Python APIs return a cached char* value that's only valid + // as long as the original object stays around, and we're + // about to (probably) toss it. Hence the copy to std::string. + OwnedObject py_str = this->PyStr(); + if (!py_str) { + return "(nil)"; + } + return PyUnicode_AsUTF8(py_str.borrow()); + } + return "(nil)"; + } + + template + inline OwnedObject PyObjectPointer::PyGetAttr(const ImmortalObject& name) const noexcept + { + assert(this->p); + return OwnedObject::consuming(PyObject_GetAttr(reinterpret_cast(this->p), name)); + } + + template + inline OwnedObject PyObjectPointer::PyRequireAttr(const char* const name) const + { + assert(this->p); + return OwnedObject::consuming(Require(PyObject_GetAttrString(this->p, name), name)); + } + + template + inline OwnedObject PyObjectPointer::PyRequireAttr(const ImmortalString& name) const + { + assert(this->p); + return OwnedObject::consuming(Require( + PyObject_GetAttr( + reinterpret_cast(this->p), + name + ), + name + )); + } + + template + inline OwnedObject PyObjectPointer::PyCall(const BorrowedObject& arg) const + { + return this->PyCall(arg.borrow()); + } + + template + inline OwnedObject PyObjectPointer::PyCall(PyGreenlet* arg) const + { + return this->PyCall(reinterpret_cast(arg)); + } + + template + inline OwnedObject PyObjectPointer::PyCall(PyObject* arg) const + { + assert(this->p); + return OwnedObject::consuming(PyObject_CallFunctionObjArgs(this->p, arg, NULL)); + } + + template + inline OwnedObject PyObjectPointer::PyCall(const BorrowedObject args, + const BorrowedObject kwargs) const + { + assert(this->p); + return OwnedObject::consuming(PyObject_Call(this->p, args, kwargs)); + } + + template + inline OwnedObject PyObjectPointer::PyCall(const OwnedObject& args, + const OwnedObject& kwargs) const + { + assert(this->p); + return OwnedObject::consuming(PyObject_Call(this->p, args.borrow(), kwargs.borrow())); + } + + inline void + ListChecker(void * p) + { + if (!p) { + return; + } + if (!PyList_Check(p)) { + throw TypeError("Expected a list"); + } + } + + class OwnedList : public OwnedReference + { + private: + G_NO_ASSIGNMENT_OF_CLS(OwnedList); + public: + // TODO: Would like to use move. + explicit OwnedList(const OwnedObject& other) + : OwnedReference(other) + { + } + + OwnedList& operator=(const OwnedObject& other) + { + if (other && PyList_Check(other.p)) { + // Valid list. Own a new reference to it, discard the + // reference to what we did own. + PyObject* new_ptr = other.p; + Py_INCREF(new_ptr); + Py_XDECREF(this->p); + this->p = new_ptr; + } + else { + // Either the other object was NULL (an error) or it + // wasn't a list. Either way, we're now invalidated. + Py_XDECREF(this->p); + this->p = nullptr; + } + return *this; + } + + inline bool empty() const + { + return PyList_GET_SIZE(p) == 0; + } + + inline Py_ssize_t size() const + { + return PyList_GET_SIZE(p); + } + + inline BorrowedObject at(const Py_ssize_t index) const + { + return PyList_GET_ITEM(p, index); + } + + inline void clear() + { + PyList_SetSlice(p, 0, PyList_GET_SIZE(p), NULL); + } + }; + + // Use this to represent the module object used at module init + // time. + // This could either be a borrowed (Py2) or new (Py3) reference; + // either way, we don't want to do any memory management + // on it here, Python itself will handle that. + // XXX: Actually, that's not quite right. On Python 3, if an + // exception occurs before we return to the interpreter, this will + // leak; but all previous versions also had that problem. + class CreatedModule : public PyObjectPointer<> + { + private: + G_NO_COPIES_OF_CLS(CreatedModule); + public: + CreatedModule(PyModuleDef& mod_def) : PyObjectPointer<>( + Require(PyModule_Create(&mod_def))) + { + } + + // PyAddObject(): Add a reference to the object to the module. + // On return, the reference count of the object is unchanged. + // + // The docs warn that PyModule_AddObject only steals the + // reference on success, so if it fails after we've incref'd + // or allocated, we're responsible for the decref. + void PyAddObject(const char* name, const long new_bool) + { + OwnedObject p = OwnedObject::consuming(Require(PyBool_FromLong(new_bool))); + this->PyAddObject(name, p); + } + + void PyAddObject(const char* name, const OwnedObject& new_object) + { + // The caller already owns a reference they will decref + // when their variable goes out of scope, we still need to + // incref/decref. + this->PyAddObject(name, new_object.borrow()); + } + + void PyAddObject(const char* name, const ImmortalObject& new_object) + { + this->PyAddObject(name, new_object.borrow()); + } + + void PyAddObject(const char* name, PyTypeObject& type) + { + this->PyAddObject(name, reinterpret_cast(&type)); + } + + void PyAddObject(const char* name, PyObject* new_object) + { + Py_INCREF(new_object); + try { + Require(PyModule_AddObject(this->p, name, new_object)); + } + catch (const PyErrOccurred&) { + Py_DECREF(p); + throw; + } + } + }; + + class PyErrFetchParam : public PyObjectPointer<> + { + // Not an owned object, because we can't be initialized with + // one, and we only sometimes acquire ownership. + private: + G_NO_COPIES_OF_CLS(PyErrFetchParam); + public: + // To allow declaring these and passing them to + // PyErr_Fetch we implement the empty constructor, + // and the address operator. + PyErrFetchParam() : PyObjectPointer<>(nullptr) + { + } + + PyObject** operator&() + { + return &this->p; + } + + // This allows us to pass one directly without the &, + // BUT it has higher precedence than the bool operator + // if it's not explicit. + operator PyObject**() + { + return &this->p; + } + + // We don't want to be able to pass these to Py_DECREF and + // such so we don't have the implicit PyObject* conversion. + + inline PyObject* relinquish_ownership() + { + PyObject* result = this->p; + this->p = nullptr; + return result; + } + + ~PyErrFetchParam() + { + Py_XDECREF(p); + } + }; + + class OwnedErrPiece : public OwnedObject + { + private: + + public: + // Unlike OwnedObject, this increments the refcount. + OwnedErrPiece(PyObject* p=nullptr) : OwnedObject(p) + { + this->acquire(); + } + + PyObject** operator&() + { + return &this->p; + } + + inline operator PyObject*() const + { + return this->p; + } + + operator PyTypeObject*() const + { + return reinterpret_cast(this->p); + } + }; + + class PyErrPieces + { + private: + OwnedErrPiece type; + OwnedErrPiece instance; + OwnedErrPiece traceback; + bool restored; + public: + // Takes new references; if we're destroyed before + // restoring the error, we drop the references. + PyErrPieces(PyObject* t, PyObject* v, PyObject* tb) : + type(t), + instance(v), + traceback(tb), + restored(0) + { + this->normalize(); + } + + PyErrPieces() : + restored(0) + { + // PyErr_Fetch transfers ownership to us, so + // we don't actually need to INCREF; but we *do* + // need to DECREF if we're not restored. + PyErrFetchParam t, v, tb; + PyErr_Fetch(&t, &v, &tb); + type.steal(t.relinquish_ownership()); + instance.steal(v.relinquish_ownership()); + traceback.steal(tb.relinquish_ownership()); + } + + void PyErrRestore() + { + // can only do this once + assert(!this->restored); + this->restored = true; + PyErr_Restore( + this->type.relinquish_ownership(), + this->instance.relinquish_ownership(), + this->traceback.relinquish_ownership()); + assert(!this->type && !this->instance && !this->traceback); + } + + private: + void normalize() + { + // First, check the traceback argument, replacing None, + // with NULL + if (traceback.is_None()) { + traceback = nullptr; + } + + if (traceback && !PyTraceBack_Check(traceback.borrow())) { + throw PyErrOccurred(PyExc_TypeError, + "throw() third argument must be a traceback object"); + } + + if (PyExceptionClass_Check(type)) { + // If we just had a type, we'll now have a type and + // instance. + // The type's refcount will have gone up by one + // because of the instance and the instance will have + // a refcount of one. Either way, we owned, and still + // do own, exactly one reference. + PyErr_NormalizeException(&type, &instance, &traceback); + + } + else if (PyExceptionInstance_Check(type)) { + /* Raising an instance --- usually that means an + object that is a subclass of BaseException, but on + Python 2, that can also mean an arbitrary old-style + object. The value should be a dummy. */ + if (instance && !instance.is_None()) { + throw PyErrOccurred( + PyExc_TypeError, + "instance exception may not have a separate value"); + } + /* Normalize to raise , */ + this->instance = this->type; + this->type = PyExceptionInstance_Class(instance.borrow()); + + /* + It would be tempting to do this: + + Py_ssize_t type_count = Py_REFCNT(Py_TYPE(instance.borrow())); + this->type = PyExceptionInstance_Class(instance.borrow()); + assert(this->type.REFCNT() == type_count + 1); + + But that doesn't work on Python 2 in the case of + old-style instances: The result of Py_TYPE is going to + be the global shared that all + old-style classes have, while the return of Instance_Class() + will be the Python-level class object. The two are unrelated. + */ + } + else { + /* Not something you can raise. throw() fails. */ + PyErr_Format(PyExc_TypeError, + "exceptions must be classes, or instances, not %s", + Py_TYPE(type.borrow())->tp_name); + throw PyErrOccurred(); + } + } + }; + + // PyArg_Parse's O argument returns a borrowed reference. + class PyArgParseParam : public BorrowedObject + { + private: + G_NO_COPIES_OF_CLS(PyArgParseParam); + public: + explicit PyArgParseParam(PyObject* p=nullptr) : BorrowedObject(p) + { + } + + inline PyObject** operator&() + { + return &this->p; + } + }; + +};}; + +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet_slp_switch.hpp b/.venv/Lib/site-packages/greenlet/greenlet_slp_switch.hpp new file mode 100644 index 0000000..bd4b7ae --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_slp_switch.hpp @@ -0,0 +1,99 @@ +#ifndef GREENLET_SLP_SWITCH_HPP +#define GREENLET_SLP_SWITCH_HPP + +#include "greenlet_compiler_compat.hpp" +#include "greenlet_refs.hpp" + +/* + * the following macros are spliced into the OS/compiler + * specific code, in order to simplify maintenance. + */ +// We can save about 10% of the time it takes to switch greenlets if +// we thread the thread state through the slp_save_state() and the +// following slp_restore_state() calls from +// slp_switch()->g_switchstack() (which already needs to access it). +// +// However: +// +// that requires changing the prototypes and implementations of the +// switching functions. If we just change the prototype of +// slp_switch() to accept the argument and update the macros, without +// changing the implementation of slp_switch(), we get crashes on +// 64-bit Linux and 32-bit x86 (for reasons that aren't 100% clear); +// on the other hand, 64-bit macOS seems to be fine. Also, 64-bit +// windows is an issue because slp_switch is written fully in assembly +// and currently ignores its argument so some code would have to be +// adjusted there to pass the argument on to the +// ``slp_save_state_asm()`` function (but interestingly, because of +// the calling convention, the extra argument is just ignored and +// things function fine, albeit slower, if we just modify +// ``slp_save_state_asm`()` to fetch the pointer to pass to the +// macro.) +// +// Our compromise is to use a *glabal*, untracked, weak, pointer +// to the necessary thread state during the process of switching only. +// This is safe because we're protected by the GIL, and if we're +// running this code, the thread isn't exiting. This also nets us a +// 10-12% speed improvement. + +static greenlet::Greenlet* volatile switching_thread_state = nullptr; + + +extern "C" { +static int GREENLET_NOINLINE(slp_save_state_trampoline)(char* stackref); +static void GREENLET_NOINLINE(slp_restore_state_trampoline)(); +} + + +#define SLP_SAVE_STATE(stackref, stsizediff) \ +do { \ + assert(switching_thread_state); \ + stackref += STACK_MAGIC; \ + if (slp_save_state_trampoline((char*)stackref)) \ + return -1; \ + if (!switching_thread_state->active()) \ + return 1; \ + stsizediff = switching_thread_state->stack_start() - (char*)stackref; \ +} while (0) + +#define SLP_RESTORE_STATE() slp_restore_state_trampoline() + +#define SLP_EVAL +extern "C" { +#define slp_switch GREENLET_NOINLINE(slp_switch) +#include "slp_platformselect.h" +} +#undef slp_switch + +#ifndef STACK_MAGIC +# error \ + "greenlet needs to be ported to this platform, or taught how to detect your compiler properly." +#endif /* !STACK_MAGIC */ + + + +#ifdef EXTERNAL_ASM +/* CCP addition: Make these functions, to be called from assembler. + * The token include file for the given platform should enable the + * EXTERNAL_ASM define so that this is included. + */ +extern "C" { +intptr_t +slp_save_state_asm(intptr_t* ref) +{ + intptr_t diff; + SLP_SAVE_STATE(ref, diff); + return diff; +} + +void +slp_restore_state_asm(void) +{ + SLP_RESTORE_STATE(); +} + +extern int slp_switch(void); +}; +#endif + +#endif diff --git a/.venv/Lib/site-packages/greenlet/greenlet_thread_support.hpp b/.venv/Lib/site-packages/greenlet/greenlet_thread_support.hpp new file mode 100644 index 0000000..3ded7d2 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/greenlet_thread_support.hpp @@ -0,0 +1,31 @@ +#ifndef GREENLET_THREAD_SUPPORT_HPP +#define GREENLET_THREAD_SUPPORT_HPP + +/** + * Defines various utility functions to help greenlet integrate well + * with threads. This used to be needed when we supported Python + * 2.7 on Windows, which used a very old compiler. We wrote an + * alternative implementation using Python APIs and POSIX or Windows + * APIs, but that's no longer needed. So this file is a shadow of its + * former self --- but may be needed in the future. + */ + +#include +#include +#include + +#include "greenlet_compiler_compat.hpp" + +namespace greenlet { + typedef std::mutex Mutex; + typedef std::lock_guard LockGuard; + class LockInitError : public std::runtime_error + { + public: + LockInitError(const char* what) : std::runtime_error(what) + {}; + }; +}; + + +#endif /* GREENLET_THREAD_SUPPORT_HPP */ diff --git a/.venv/Lib/site-packages/greenlet/platform/__init__.py b/.venv/Lib/site-packages/greenlet/platform/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/greenlet/platform/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/platform/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..afd8266e006af0e394134bc0bdcb322f9925e537 GIT binary patch literal 215 zcmZ9GJqp4=5QVcwL4+K{!f30Ajjd=JyMbksjO&`8U1rxnPU0Cni#HIgJb{Rfm7CTF z@4at^DdrYMqrmI4d&sVzUHt3a_nS-524l9p2GsM@ySw=|>jmsBk_Dl1QWlanI|`~2 z(kINE1w#{wHIi_epw!Yr>XQp&cy%u3Gl(0k8`!86ta3OpA}fSM3z87)65Z64!W}eK hQ_fYb9OtoV@55!K^K*$S8u&Mux9#8+GR7$M^aImUKEeP1 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd b/.venv/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd new file mode 100644 index 0000000..038ced2 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/setup_switch_x64_masm.cmd @@ -0,0 +1,2 @@ +call "C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat" amd64 +ml64 /nologo /c /Fo switch_x64_masm.obj switch_x64_masm.asm diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h b/.venv/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h new file mode 100644 index 0000000..058617c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_aarch64_gcc.h @@ -0,0 +1,124 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 07-Sep-16 Add clang support using x register naming. Fredrik Fornwall + * 13-Apr-13 Add support for strange GCC caller-save decisions + * 08-Apr-13 File creation. Michael Matz + * + * NOTES + * + * Simply save all callee saved registers + * + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL +#define STACK_MAGIC 0 +#define REGS_TO_SAVE "x19", "x20", "x21", "x22", "x23", "x24", "x25", "x26", \ + "x27", "x28", "x30" /* aka lr */, \ + "v8", "v9", "v10", "v11", \ + "v12", "v13", "v14", "v15" + +/* + * Recall: + asm asm-qualifiers ( AssemblerTemplate + : OutputOperands + [ : InputOperands + [ : Clobbers ] ]) + + or (if asm-qualifiers contains 'goto') + + asm asm-qualifiers ( AssemblerTemplate + : OutputOperands + : InputOperands + : Clobbers + : GotoLabels) + + and OutputOperands are + + [ [asmSymbolicName] ] constraint (cvariablename) + + When a name is given, refer to it as ``%[the name]``. + When not given, ``%i`` where ``i`` is the zero-based index. + + constraints starting with ``=`` means only writing; ``+`` means + reading and writing. + + This is followed by ``r`` (must be register) or ``m`` (must be memory) + and these can be combined. + + The ``cvariablename`` is actually an lvalue expression. + + In AArch65, 31 general purpose registers. If named X0... they are + 64-bit. If named W0... they are the bottom 32 bits of the + corresponding 64 bit register. + + XZR and WZR are hardcoded to 0, and ignore writes. + + Arguments are in X0..X7. C++ uses X0 for ``this``. X0 holds simple return + values (?) + + Whenever a W register is written, the top half of the X register is zeroed. + */ + +static int +slp_switch(void) +{ + int err; + void *fp; + /* Windowz uses a 32-bit long on a 64-bit platform, unlike the rest of + the world, and in theory we can be compiled with GCC/llvm on 64-bit + windows. So we need a fixed-width type. + */ + int64_t *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("str x29, %0" : "=m"(fp) : : ); + __asm__ ("mov %0, sp" : "=r" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "add sp,sp,%0\n" + "add x29,x29,%0\n" + : + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + /* SLP_SAVE_STATE macro contains some return statements + (of -1 and 1). It falls through only when + the return value of slp_save_state() is zero, which + is placed in x0. + In that case we (slp_switch) also want to return zero + (also in x0 of course). + Now, some GCC versions (seen with 4.8) think it's a + good idea to save/restore x0 around the call to + slp_restore_state(), instead of simply zeroing it + at the return below. But slp_restore_state + writes random values to the stack slot used for this + save/restore (from when it once was saved above in + SLP_SAVE_STATE, when it was still uninitialized), so + "restoring" that precious zero actually makes us + return random values. There are some ways to make + GCC not use that zero value in the normal return path + (e.g. making err volatile, but that costs a little + stack space), and the simplest is to call a function + that returns an unknown value (which happens to be zero), + so the saved/restored value is unused. + + Thus, this line stores a 0 into the ``err`` variable + (which must be held in a register for this instruction, + of course). The ``w`` qualifier causes the instruction + to use W0 instead of X0, otherwise we get a warning + about a value size mismatch (because err is an int, + and aarch64 platforms are LP64: 32-bit int, 64 bit long + and pointer). + */ + __asm__ volatile ("mov %w0, #0" : "=r" (err)); + } + __asm__ volatile ("ldr x29, %0" : : "m" (fp) :); + __asm__ volatile ("" : : : REGS_TO_SAVE); + return err; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_alpha_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_alpha_unix.h new file mode 100644 index 0000000..7e07abf --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_alpha_unix.h @@ -0,0 +1,30 @@ +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "$9", "$10", "$11", "$12", "$13", "$14", "$15", \ + "$f2", "$f3", "$f4", "$f5", "$f6", "$f7", "$f8", "$f9" + +static int +slp_switch(void) +{ + int ret; + long *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("mov $30, %0" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "addq $30, %0, $30\n\t" + : /* no outputs */ + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("mov $31, %0" : "=r" (ret) : ); + return ret; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_amd64_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_amd64_unix.h new file mode 100644 index 0000000..d470110 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_amd64_unix.h @@ -0,0 +1,87 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 3-May-13 Ralf Schmitt + * Add support for strange GCC caller-save decisions + * (ported from switch_aarch64_gcc.h) + * 18-Aug-11 Alexey Borzenkov + * Correctly save rbp, csr and cw + * 01-Apr-04 Hye-Shik Chang + * Ported from i386 to amd64. + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for spark + * 31-Avr-02 Armin Rigo + * Added ebx, esi and edi register-saves. + * 01-Mar-02 Samual M. Rushing + * Ported from i386. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +/* #define STACK_MAGIC 3 */ +/* the above works fine with gcc 2.96, but 2.95.3 wants this */ +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "r12", "r13", "r14", "r15" + +static int +slp_switch(void) +{ + int err; + void* rbp; + void* rbx; + unsigned int csr; + unsigned short cw; + /* This used to be declared 'register', but that does nothing in + modern compilers and is explicitly forbidden in some new + standards. */ + long *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("fstcw %0" : "=m" (cw)); + __asm__ volatile ("stmxcsr %0" : "=m" (csr)); + __asm__ volatile ("movq %%rbp, %0" : "=m" (rbp)); + __asm__ volatile ("movq %%rbx, %0" : "=m" (rbx)); + __asm__ ("movq %%rsp, %0" : "=g" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "addq %0, %%rsp\n" + "addq %0, %%rbp\n" + : + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + __asm__ volatile ("xorq %%rax, %%rax" : "=a" (err)); + } + __asm__ volatile ("movq %0, %%rbx" : : "m" (rbx)); + __asm__ volatile ("movq %0, %%rbp" : : "m" (rbp)); + __asm__ volatile ("ldmxcsr %0" : : "m" (csr)); + __asm__ volatile ("fldcw %0" : : "m" (cw)); + __asm__ volatile ("" : : : REGS_TO_SAVE); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h b/.venv/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h new file mode 100644 index 0000000..655003a --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_arm32_gcc.h @@ -0,0 +1,79 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 14-Aug-06 File creation. Ported from Arm Thumb. Sylvain Baro + * 3-Sep-06 Commented out saving of r1-r3 (r4 already commented out) as I + * read that these do not need to be saved. Also added notes and + * errors related to the frame pointer. Richard Tew. + * + * NOTES + * + * It is not possible to detect if fp is used or not, so the supplied + * switch function needs to support it, so that you can remove it if + * it does not apply to you. + * + * POSSIBLE ERRORS + * + * "fp cannot be used in asm here" + * + * - Try commenting out "fp" in REGS_TO_SAVE. + * + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL +#define STACK_MAGIC 0 +#define REG_SP "sp" +#define REG_SPSP "sp,sp" +#ifdef __thumb__ +#define REG_FP "r7" +#define REG_FPFP "r7,r7" +#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r8", "r9", "r10", "r11", "lr" +#else +#define REG_FP "fp" +#define REG_FPFP "fp,fp" +#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r7", "r8", "r9", "r10", "lr" +#endif +#if defined(__SOFTFP__) +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL +#elif defined(__VFP_FP__) +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "d8", "d9", "d10", "d11", \ + "d12", "d13", "d14", "d15" +#elif defined(__MAVERICK__) +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "mvf4", "mvf5", "mvf6", "mvf7", \ + "mvf8", "mvf9", "mvf10", "mvf11", \ + "mvf12", "mvf13", "mvf14", "mvf15" +#else +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "f4", "f5", "f6", "f7" +#endif + +static int +#ifdef __GNUC__ +__attribute__((optimize("no-omit-frame-pointer"))) +#endif +slp_switch(void) +{ + void *fp; + int *stackref, stsizediff; + int result; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("mov r0," REG_FP "\n\tstr r0,%0" : "=m" (fp) : : "r0"); + __asm__ ("mov %0," REG_SP : "=r" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "add " REG_SPSP ",%0\n" + "add " REG_FPFP ",%0\n" + : + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("ldr r0,%1\n\tmov " REG_FP ",r0\n\tmov %0, #0" : "=r" (result) : "m" (fp) : "r0"); + __asm__ volatile ("" : : : REGS_TO_SAVE); + return result; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_arm32_ios.h b/.venv/Lib/site-packages/greenlet/platform/switch_arm32_ios.h new file mode 100644 index 0000000..9e640e1 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_arm32_ios.h @@ -0,0 +1,67 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 31-May-15 iOS support. Ported from arm32. Proton + * + * NOTES + * + * It is not possible to detect if fp is used or not, so the supplied + * switch function needs to support it, so that you can remove it if + * it does not apply to you. + * + * POSSIBLE ERRORS + * + * "fp cannot be used in asm here" + * + * - Try commenting out "fp" in REGS_TO_SAVE. + * + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 0 +#define REG_SP "sp" +#define REG_SPSP "sp,sp" +#define REG_FP "r7" +#define REG_FPFP "r7,r7" +#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r8", "r10", "r11", "lr" +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "d8", "d9", "d10", "d11", \ + "d12", "d13", "d14", "d15" + +static int +#ifdef __GNUC__ +__attribute__((optimize("no-omit-frame-pointer"))) +#endif +slp_switch(void) +{ + void *fp; + int *stackref, stsizediff, result; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("str " REG_FP ",%0" : "=m" (fp)); + __asm__ ("mov %0," REG_SP : "=r" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "add " REG_SPSP ",%0\n" + "add " REG_FPFP ",%0\n" + : + : "r" (stsizediff) + : REGS_TO_SAVE /* Clobber registers, force compiler to + * recalculate address of void *fp from REG_SP or REG_FP */ + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ( + "ldr " REG_FP ", %1\n\t" + "mov %0, #0" + : "=r" (result) + : "m" (fp) + : REGS_TO_SAVE /* Force compiler to restore saved registers after this */ + ); + return result; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm b/.venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm new file mode 100644 index 0000000..29f9c22 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.asm @@ -0,0 +1,53 @@ + AREA switch_arm64_masm, CODE, READONLY; + GLOBAL slp_switch [FUNC] + EXTERN slp_save_state_asm + EXTERN slp_restore_state_asm + +slp_switch + ; push callee saved registers to stack + stp x19, x20, [sp, #-16]! + stp x21, x22, [sp, #-16]! + stp x23, x24, [sp, #-16]! + stp x25, x26, [sp, #-16]! + stp x27, x28, [sp, #-16]! + stp x29, x30, [sp, #-16]! + stp d8, d9, [sp, #-16]! + stp d10, d11, [sp, #-16]! + stp d12, d13, [sp, #-16]! + stp d14, d15, [sp, #-16]! + + ; call slp_save_state_asm with stack pointer + mov x0, sp + bl slp_save_state_asm + + ; early return for return value of 1 and -1 + cmp x0, #-1 + b.eq RETURN + cmp x0, #1 + b.eq RETURN + + ; increment stack and frame pointer + add sp, sp, x0 + add x29, x29, x0 + + bl slp_restore_state_asm + + ; store return value for successful completion of routine + mov x0, #0 + +RETURN + ; pop registers from stack + ldp d14, d15, [sp], #16 + ldp d12, d13, [sp], #16 + ldp d10, d11, [sp], #16 + ldp d8, d9, [sp], #16 + ldp x29, x30, [sp], #16 + ldp x27, x28, [sp], #16 + ldp x25, x26, [sp], #16 + ldp x23, x24, [sp], #16 + ldp x21, x22, [sp], #16 + ldp x19, x20, [sp], #16 + + ret + + END diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.obj b/.venv/Lib/site-packages/greenlet/platform/switch_arm64_masm.obj new file mode 100644 index 0000000000000000000000000000000000000000..f6f220e4310baaa9756110685ce7d6a2bdf90c37 GIT binary patch literal 746 zcma)4PiqrF6n~qoo~*PNZ{i+=wji4b#Xu2~wiJpGk)*AMF07NyB(9n1#+i+!)I;v| zBKQG3?t1eB$T(lYgGb4+lu{_QmQrebldQB_4?cMF-uu0IZ{DA2e8@rZ+e^~30488W z`B{KPh%yV{HEIpyeum^wI#7P*HfX)ux?9U&c!SFK-$o|OFtKn{Q|a-#N>2inp0-tb zCRKXAtg2SolaoLv$Ll&ds_Epj?SH+8K{t?XSjKaFsEy%yh}=V70BaHj zEY5kWk_zcJo{$SSUL~=K(zW|tnhm$rA z<%dZ$q?>RX*18r{!azhaYR1lVb;g;mR-6h!#F>|p@;aje%0a|CZrE7s+SXuT>MS=Y ziQPiMY-5DD&5+S7^H03fy7qt7ir}L34kK|h68s-MU>{lXOqlr?!Y=`~WwviNenFS_ zZalVSHh-0FU4lj#X8u5`ODn6@#{f?dHE&%XdP~_I3;$RS9-(z*>>ydkm*f@oWlUn~ Qn+^;lsEi}=H#!Q3U&UU-WdHyG literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h b/.venv/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h new file mode 100644 index 0000000..7ab7f45 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_arm64_msvc.h @@ -0,0 +1,17 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 21-Oct-21 Niyas Sait + * First version to enable win/arm64 support. + */ + +#define STACK_REFPLUS 1 +#define STACK_MAGIC 0 + +/* Use the generic support for an external assembly language slp_switch function. */ +#define EXTERNAL_ASM + +#ifdef SLP_EVAL +/* This always uses the external masm assembly file. */ +#endif \ No newline at end of file diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_csky_gcc.h b/.venv/Lib/site-packages/greenlet/platform/switch_csky_gcc.h new file mode 100644 index 0000000..ac469d3 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_csky_gcc.h @@ -0,0 +1,48 @@ +#ifdef SLP_EVAL +#define STACK_MAGIC 0 +#define REG_FP "r8" +#ifdef __CSKYABIV2__ +#define REGS_TO_SAVE_GENERAL "r4", "r5", "r6", "r7", "r9", "r10", "r11", "r15",\ + "r16", "r17", "r18", "r19", "r20", "r21", "r22",\ + "r23", "r24", "r25" + +#if defined (__CSKY_HARD_FLOAT__) || (__CSKY_VDSP__) +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL, "vr8", "vr9", "vr10", "vr11", "vr12",\ + "vr13", "vr14", "vr15" +#else +#define REGS_TO_SAVE REGS_TO_SAVE_GENERAL +#endif +#else +#define REGS_TO_SAVE "r9", "r10", "r11", "r12", "r13", "r15" +#endif + + +static int +#ifdef __GNUC__ +__attribute__((optimize("no-omit-frame-pointer"))) +#endif +slp_switch(void) +{ + int *stackref, stsizediff; + int result; + + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ ("mov %0, sp" : "=r" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "addu sp,%0\n" + "addu "REG_FP",%0\n" + : + : "r" (stsizediff) + ); + + SLP_RESTORE_STATE(); + } + __asm__ volatile ("movi %0, 0" : "=r" (result)); + __asm__ volatile ("" : : : REGS_TO_SAVE); + + return result; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h b/.venv/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h new file mode 100644 index 0000000..9eaf34e --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_loongarch64_linux.h @@ -0,0 +1,31 @@ +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "s0", "s1", "s2", "s3", "s4", "s5", \ + "s6", "s7", "s8", "fp", \ + "f24", "f25", "f26", "f27", "f28", "f29", "f30", "f31" + +static int +slp_switch(void) +{ + int ret; + long *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("move %0, $sp" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "add.d $sp, $sp, %0\n\t" + : /* no outputs */ + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("move %0, $zero" : "=r" (ret) : ); + return ret; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h b/.venv/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h new file mode 100644 index 0000000..da761c2 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_m68k_gcc.h @@ -0,0 +1,38 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 2014-01-06 Andreas Schwab + * File created. + */ + +#ifdef SLP_EVAL + +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "%d2", "%d3", "%d4", "%d5", "%d6", "%d7", \ + "%a2", "%a3", "%a4" + +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; + void *fp, *a5; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("move.l %%fp, %0" : "=m"(fp)); + __asm__ volatile ("move.l %%a5, %0" : "=m"(a5)); + __asm__ ("move.l %%sp, %0" : "=r"(stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ("add.l %0, %%sp; add.l %0, %%fp" : : "r"(stsizediff)); + SLP_RESTORE_STATE(); + __asm__ volatile ("clr.l %0" : "=g" (err)); + } + __asm__ volatile ("move.l %0, %%a5" : : "m"(a5)); + __asm__ volatile ("move.l %0, %%fp" : : "m"(fp)); + __asm__ volatile ("" : : : REGS_TO_SAVE); + return err; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_mips_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_mips_unix.h new file mode 100644 index 0000000..b9003e9 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_mips_unix.h @@ -0,0 +1,64 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 20-Sep-14 Matt Madison + * Re-code the saving of the gp register for MIPS64. + * 05-Jan-08 Thiemo Seufer + * Ported from ppc. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "$16", "$17", "$18", "$19", "$20", "$21", "$22", \ + "$23", "$30" +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; +#ifdef __mips64 + uint64_t gpsave; +#endif + __asm__ __volatile__ ("" : : : REGS_TO_SAVE); +#ifdef __mips64 + __asm__ __volatile__ ("sd $28,%0" : "=m" (gpsave) : : ); +#endif + __asm__ ("move %0, $29" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ __volatile__ ( +#ifdef __mips64 + "daddu $29, %0\n" +#else + "addu $29, %0\n" +#endif + : /* no outputs */ + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } +#ifdef __mips64 + __asm__ __volatile__ ("ld $28,%0" : : "m" (gpsave) : ); +#endif + __asm__ __volatile__ ("" : : : REGS_TO_SAVE); + __asm__ __volatile__ ("move %0, $0" : "=r" (err)); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h b/.venv/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h new file mode 100644 index 0000000..e7e0b87 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_ppc64_aix.h @@ -0,0 +1,103 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 16-Oct-20 Jesse Gorzinski + * Copied from Linux PPC64 implementation + * 04-Sep-18 Alexey Borzenkov + * Workaround a gcc bug using manual save/restore of r30 + * 21-Mar-18 Tulio Magno Quites Machado Filho + * Added r30 to the list of saved registers in order to fully comply with + * both ppc64 ELFv1 ABI and the ppc64le ELFv2 ABI, that classify this + * register as a nonvolatile register used for local variables. + * 21-Mar-18 Laszlo Boszormenyi + * Save r2 (TOC pointer) manually. + * 10-Dec-13 Ulrich Weigand + * Support ELFv2 ABI. Save float/vector registers. + * 09-Mar-12 Michael Ellerman + * 64-bit implementation, copied from 32-bit. + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'r31' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 14-Jan-04 Bob Ippolito + * added cr2-cr4 to the registers to be saved. + * Open questions: Should we save FP registers? + * What about vector registers? + * Differences between darwin and unix? + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 04-Oct-02 Gustavo Niemeyer + * Ported from MacOS version. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 29-Jun-02 Christian Tismer + * Added register 13-29, 31 saves. The same way as + * Armin Rigo did for the x86_unix version. + * This seems to be now fully functional! + * 04-Mar-02 Hye-Shik Chang + * Ported from i386. + * 31-Jul-12 Trevor Bowen + * Changed memory constraints to register only. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 6 + +#if defined(__ALTIVEC__) +#define ALTIVEC_REGS \ + "v20", "v21", "v22", "v23", "v24", "v25", "v26", "v27", \ + "v28", "v29", "v30", "v31", +#else +#define ALTIVEC_REGS +#endif + +#define REGS_TO_SAVE "r14", "r15", "r16", "r17", "r18", "r19", "r20", \ + "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \ + "r31", \ + "fr14", "fr15", "fr16", "fr17", "fr18", "fr19", "fr20", "fr21", \ + "fr22", "fr23", "fr24", "fr25", "fr26", "fr27", "fr28", "fr29", \ + "fr30", "fr31", \ + ALTIVEC_REGS \ + "cr2", "cr3", "cr4" + +static int +slp_switch(void) +{ + int err; + long *stackref, stsizediff; + void * toc; + void * r30; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("std 2, %0" : "=m" (toc)); + __asm__ volatile ("std 30, %0" : "=m" (r30)); + __asm__ ("mr %0, 1" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "mr 11, %0\n" + "add 1, 1, 11\n" + : /* no outputs */ + : "r" (stsizediff) + : "11" + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("ld 30, %0" : : "m" (r30)); + __asm__ volatile ("ld 2, %0" : : "m" (toc)); + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("li %0, 0" : "=r" (err)); + return err; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h b/.venv/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h new file mode 100644 index 0000000..3c324d0 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_ppc64_linux.h @@ -0,0 +1,105 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 04-Sep-18 Alexey Borzenkov + * Workaround a gcc bug using manual save/restore of r30 + * 21-Mar-18 Tulio Magno Quites Machado Filho + * Added r30 to the list of saved registers in order to fully comply with + * both ppc64 ELFv1 ABI and the ppc64le ELFv2 ABI, that classify this + * register as a nonvolatile register used for local variables. + * 21-Mar-18 Laszlo Boszormenyi + * Save r2 (TOC pointer) manually. + * 10-Dec-13 Ulrich Weigand + * Support ELFv2 ABI. Save float/vector registers. + * 09-Mar-12 Michael Ellerman + * 64-bit implementation, copied from 32-bit. + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'r31' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 14-Jan-04 Bob Ippolito + * added cr2-cr4 to the registers to be saved. + * Open questions: Should we save FP registers? + * What about vector registers? + * Differences between darwin and unix? + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 04-Oct-02 Gustavo Niemeyer + * Ported from MacOS version. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 29-Jun-02 Christian Tismer + * Added register 13-29, 31 saves. The same way as + * Armin Rigo did for the x86_unix version. + * This seems to be now fully functional! + * 04-Mar-02 Hye-Shik Chang + * Ported from i386. + * 31-Jul-12 Trevor Bowen + * Changed memory constraints to register only. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#if _CALL_ELF == 2 +#define STACK_MAGIC 4 +#else +#define STACK_MAGIC 6 +#endif + +#if defined(__ALTIVEC__) +#define ALTIVEC_REGS \ + "v20", "v21", "v22", "v23", "v24", "v25", "v26", "v27", \ + "v28", "v29", "v30", "v31", +#else +#define ALTIVEC_REGS +#endif + +#define REGS_TO_SAVE "r14", "r15", "r16", "r17", "r18", "r19", "r20", \ + "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \ + "r31", \ + "fr14", "fr15", "fr16", "fr17", "fr18", "fr19", "fr20", "fr21", \ + "fr22", "fr23", "fr24", "fr25", "fr26", "fr27", "fr28", "fr29", \ + "fr30", "fr31", \ + ALTIVEC_REGS \ + "cr2", "cr3", "cr4" + +static int +slp_switch(void) +{ + int err; + long *stackref, stsizediff; + void * toc; + void * r30; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("std 2, %0" : "=m" (toc)); + __asm__ volatile ("std 30, %0" : "=m" (r30)); + __asm__ ("mr %0, 1" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "mr 11, %0\n" + "add 1, 1, 11\n" + : /* no outputs */ + : "r" (stsizediff) + : "11" + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("ld 30, %0" : : "m" (r30)); + __asm__ volatile ("ld 2, %0" : : "m" (toc)); + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("li %0, 0" : "=r" (err)); + return err; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_ppc_aix.h b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_aix.h new file mode 100644 index 0000000..6d93c13 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_aix.h @@ -0,0 +1,87 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 07-Mar-11 Floris Bruynooghe + * Do not add stsizediff to general purpose + * register (GPR) 30 as this is a non-volatile and + * unused by the PowerOpen Environment, therefore + * this was modifying a user register instead of the + * frame pointer (which does not seem to exist). + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'r31' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 14-Jan-04 Bob Ippolito + * added cr2-cr4 to the registers to be saved. + * Open questions: Should we save FP registers? + * What about vector registers? + * Differences between darwin and unix? + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 04-Oct-02 Gustavo Niemeyer + * Ported from MacOS version. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 29-Jun-02 Christian Tismer + * Added register 13-29, 31 saves. The same way as + * Armin Rigo did for the x86_unix version. + * This seems to be now fully functional! + * 04-Mar-02 Hye-Shik Chang + * Ported from i386. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 3 + +/* !!!!WARNING!!!! need to add "r31" in the next line if this header file + * is meant to be compiled non-dynamically! + */ +#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \ + "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \ + "cr2", "cr3", "cr4" +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ ("mr %0, 1" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "mr 11, %0\n" + "add 1, 1, 11\n" + : /* no outputs */ + : "r" (stsizediff) + : "11" + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("li %0, 0" : "=r" (err)); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_ppc_linux.h b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_linux.h new file mode 100644 index 0000000..e83ad70 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_linux.h @@ -0,0 +1,84 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'r31' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 14-Jan-04 Bob Ippolito + * added cr2-cr4 to the registers to be saved. + * Open questions: Should we save FP registers? + * What about vector registers? + * Differences between darwin and unix? + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 04-Oct-02 Gustavo Niemeyer + * Ported from MacOS version. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 29-Jun-02 Christian Tismer + * Added register 13-29, 31 saves. The same way as + * Armin Rigo did for the x86_unix version. + * This seems to be now fully functional! + * 04-Mar-02 Hye-Shik Chang + * Ported from i386. + * 31-Jul-12 Trevor Bowen + * Changed memory constraints to register only. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 3 + +/* !!!!WARNING!!!! need to add "r31" in the next line if this header file + * is meant to be compiled non-dynamically! + */ +#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \ + "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \ + "cr2", "cr3", "cr4" +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ ("mr %0, 1" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "mr 11, %0\n" + "add 1, 1, 11\n" + "add 30, 30, 11\n" + : /* no outputs */ + : "r" (stsizediff) + : "11" + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("li %0, 0" : "=r" (err)); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h new file mode 100644 index 0000000..bd414c6 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_macosx.h @@ -0,0 +1,82 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'r31' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 14-Jan-04 Bob Ippolito + * added cr2-cr4 to the registers to be saved. + * Open questions: Should we save FP registers? + * What about vector registers? + * Differences between darwin and unix? + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 29-Jun-02 Christian Tismer + * Added register 13-29, 31 saves. The same way as + * Armin Rigo did for the x86_unix version. + * This seems to be now fully functional! + * 04-Mar-02 Hye-Shik Chang + * Ported from i386. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 3 + +/* !!!!WARNING!!!! need to add "r31" in the next line if this header file + * is meant to be compiled non-dynamically! + */ +#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \ + "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \ + "cr2", "cr3", "cr4" + +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ ("; asm block 2\n\tmr %0, r1" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "; asm block 3\n" + "\tmr r11, %0\n" + "\tadd r1, r1, r11\n" + "\tadd r30, r30, r11\n" + : /* no outputs */ + : "r" (stsizediff) + : "r11" + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("li %0, 0" : "=r" (err)); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_ppc_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_unix.h new file mode 100644 index 0000000..bb18808 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_ppc_unix.h @@ -0,0 +1,82 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'r31' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 14-Jan-04 Bob Ippolito + * added cr2-cr4 to the registers to be saved. + * Open questions: Should we save FP registers? + * What about vector registers? + * Differences between darwin and unix? + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 04-Oct-02 Gustavo Niemeyer + * Ported from MacOS version. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 29-Jun-02 Christian Tismer + * Added register 13-29, 31 saves. The same way as + * Armin Rigo did for the x86_unix version. + * This seems to be now fully functional! + * 04-Mar-02 Hye-Shik Chang + * Ported from i386. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 3 + +/* !!!!WARNING!!!! need to add "r31" in the next line if this header file + * is meant to be compiled non-dynamically! + */ +#define REGS_TO_SAVE "r13", "r14", "r15", "r16", "r17", "r18", "r19", "r20", \ + "r21", "r22", "r23", "r24", "r25", "r26", "r27", "r28", "r29", \ + "cr2", "cr3", "cr4" +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ ("mr %0, 1" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "mr 11, %0\n" + "add 1, 1, 11\n" + "add 30, 30, 11\n" + : /* no outputs */ + : "r" (stsizediff) + : "11" + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("li %0, 0" : "=r" (err)); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_riscv_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_riscv_unix.h new file mode 100644 index 0000000..e74f37a --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_riscv_unix.h @@ -0,0 +1,36 @@ +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "s1", "s2", "s3", "s4", "s5", \ + "s6", "s7", "s8", "s9", "s10", "s11", "fs0", "fs1", \ + "fs2", "fs3", "fs4", "fs5", "fs6", "fs7", "fs8", "fs9", \ + "fs10", "fs11" + +static int +slp_switch(void) +{ + long fp; + int ret; + long *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("mv %0, fp" : "=r" (fp) : ); + __asm__ volatile ("mv %0, sp" : "=r" (stackref) : ); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "add sp, sp, %0\n\t" + "add fp, fp, %0\n\t" + : /* no outputs */ + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("ld fp, %0" : : "m" (fp)); + __asm__ volatile ("mv %0, zero" : "=r" (ret) : ); + return ret; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_s390_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_s390_unix.h new file mode 100644 index 0000000..9199367 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_s390_unix.h @@ -0,0 +1,87 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 25-Jan-12 Alexey Borzenkov + * Fixed Linux/S390 port to work correctly with + * different optimization options both on 31-bit + * and 64-bit. Thanks to Stefan Raabe for lots + * of testing. + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 06-Oct-02 Gustavo Niemeyer + * Ported to Linux/S390. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#ifdef __s390x__ +#define STACK_MAGIC 20 /* 20 * 8 = 160 bytes of function call area */ +#else +#define STACK_MAGIC 24 /* 24 * 4 = 96 bytes of function call area */ +#endif + +/* Technically, r11-r13 also need saving, but function prolog starts + with stm(g) and since there are so many saved registers already + it won't be optimized, resulting in all r6-r15 being saved */ +#define REGS_TO_SAVE "r6", "r7", "r8", "r9", "r10", "r14", \ + "f0", "f1", "f2", "f3", "f4", "f5", "f6", "f7", \ + "f8", "f9", "f10", "f11", "f12", "f13", "f14", "f15" + +static int +slp_switch(void) +{ + int ret; + long *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); +#ifdef __s390x__ + __asm__ volatile ("lgr %0, 15" : "=r" (stackref) : ); +#else + __asm__ volatile ("lr %0, 15" : "=r" (stackref) : ); +#endif + { + SLP_SAVE_STATE(stackref, stsizediff); +/* N.B. + r11 may be used as the frame pointer, and in that case it cannot be + clobbered and needs offsetting just like the stack pointer (but in cases + where frame pointer isn't used we might clobber it accidentally). What's + scary is that r11 is 2nd (and even 1st when GOT is used) callee saved + register that gcc would chose for surviving function calls. However, + since r6-r10 are clobbered above, their cost for reuse is reduced, so + gcc IRA will chose them over r11 (not seeing r11 is implicitly saved), + making it relatively safe to offset in all cases. :) */ + __asm__ volatile ( +#ifdef __s390x__ + "agr 15, %0\n\t" + "agr 11, %0" +#else + "ar 15, %0\n\t" + "ar 11, %0" +#endif + : /* no outputs */ + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("lhi %0, 0" : "=r" (ret) : ); + return ret; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_sh_gcc.h b/.venv/Lib/site-packages/greenlet/platform/switch_sh_gcc.h new file mode 100644 index 0000000..5ecc3b3 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_sh_gcc.h @@ -0,0 +1,36 @@ +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL +#define STACK_MAGIC 0 +#define REGS_TO_SAVE "r8", "r9", "r10", "r11", "r13", \ + "fr12", "fr13", "fr14", "fr15" + +// r12 Global context pointer, GP +// r14 Frame pointer, FP +// r15 Stack pointer, SP + +static int +slp_switch(void) +{ + int err; + void* fp; + int *stackref, stsizediff; + __asm__ volatile("" : : : REGS_TO_SAVE); + __asm__ volatile("mov.l r14, %0" : "=m"(fp) : :); + __asm__("mov r15, %0" : "=r"(stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile( + "add %0, r15\n" + "add %0, r14\n" + : /* no outputs */ + : "r"(stsizediff)); + SLP_RESTORE_STATE(); + __asm__ volatile("mov r0, %0" : "=r"(err) : :); + } + __asm__ volatile("mov.l %0, r14" : : "m"(fp) :); + __asm__ volatile("" : : : REGS_TO_SAVE); + return err; +} + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h b/.venv/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h new file mode 100644 index 0000000..96990c3 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_sparc_sun_gcc.h @@ -0,0 +1,92 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 16-May-15 Alexey Borzenkov + * Move stack spilling code inside save/restore functions + * 30-Aug-13 Floris Bruynooghe + Clean the register windows again before returning. + This does not clobber the PIC register as it leaves + the current window intact and is required for multi- + threaded code to work correctly. + * 08-Mar-11 Floris Bruynooghe + * No need to set return value register explicitly + * before the stack and framepointer are adjusted + * as none of the other registers are influenced by + * this. Also don't needlessly clean the windows + * ('ta %0" :: "i" (ST_CLEAN_WINDOWS)') as that + * clobbers the gcc PIC register (%l7). + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * added support for SunOS sparc with gcc + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + + +#define STACK_MAGIC 0 + + +#if defined(__sparcv9) +#define SLP_FLUSHW __asm__ volatile ("flushw") +#else +#define SLP_FLUSHW __asm__ volatile ("ta 3") /* ST_FLUSH_WINDOWS */ +#endif + +/* On sparc we need to spill register windows inside save/restore functions */ +#define SLP_BEFORE_SAVE_STATE() SLP_FLUSHW +#define SLP_BEFORE_RESTORE_STATE() SLP_FLUSHW + + +static int +slp_switch(void) +{ + int err; + int *stackref, stsizediff; + + /* Put current stack pointer into stackref. + * Register spilling is done in save/restore. + */ + __asm__ volatile ("mov %%sp, %0" : "=r" (stackref)); + + { + /* Thou shalt put SLP_SAVE_STATE into a local block */ + /* Copy the current stack onto the heap */ + SLP_SAVE_STATE(stackref, stsizediff); + + /* Increment stack and frame pointer by stsizediff */ + __asm__ volatile ( + "add %0, %%sp, %%sp\n\t" + "add %0, %%fp, %%fp" + : : "r" (stsizediff)); + + /* Copy new stack from it's save store on the heap */ + SLP_RESTORE_STATE(); + + __asm__ volatile ("mov %1, %0" : "=r" (err) : "i" (0)); + return err; + } +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_x32_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_x32_unix.h new file mode 100644 index 0000000..893369c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_x32_unix.h @@ -0,0 +1,63 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 17-Aug-12 Fantix King + * Ported from amd64. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 0 + +#define REGS_TO_SAVE "r12", "r13", "r14", "r15" + + +static int +slp_switch(void) +{ + void* ebp; + void* ebx; + unsigned int csr; + unsigned short cw; + int err; + int *stackref, stsizediff; + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("fstcw %0" : "=m" (cw)); + __asm__ volatile ("stmxcsr %0" : "=m" (csr)); + __asm__ volatile ("movl %%ebp, %0" : "=m" (ebp)); + __asm__ volatile ("movl %%ebx, %0" : "=m" (ebx)); + __asm__ ("movl %%esp, %0" : "=g" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "addl %0, %%esp\n" + "addl %0, %%ebp\n" + : + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + } + __asm__ volatile ("movl %0, %%ebx" : : "m" (ebx)); + __asm__ volatile ("movl %0, %%ebp" : : "m" (ebp)); + __asm__ volatile ("ldmxcsr %0" : : "m" (csr)); + __asm__ volatile ("fldcw %0" : : "m" (cw)); + __asm__ volatile ("" : : : REGS_TO_SAVE); + __asm__ volatile ("xorl %%eax, %%eax" : "=a" (err)); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_x64_masm.asm b/.venv/Lib/site-packages/greenlet/platform/switch_x64_masm.asm new file mode 100644 index 0000000..f5c72a2 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_x64_masm.asm @@ -0,0 +1,111 @@ +; +; stack switching code for MASM on x641 +; Kristjan Valur Jonsson, sept 2005 +; + + +;prototypes for our calls +slp_save_state_asm PROTO +slp_restore_state_asm PROTO + + +pushxmm MACRO reg + sub rsp, 16 + .allocstack 16 + movaps [rsp], reg ; faster than movups, but we must be aligned + ; .savexmm128 reg, offset (don't know what offset is, no documentation) +ENDM +popxmm MACRO reg + movaps reg, [rsp] ; faster than movups, but we must be aligned + add rsp, 16 +ENDM + +pushreg MACRO reg + push reg + .pushreg reg +ENDM +popreg MACRO reg + pop reg +ENDM + + +.code +slp_switch PROC FRAME + ;realign stack to 16 bytes after return address push, makes the following faster + sub rsp,8 + .allocstack 8 + + pushxmm xmm15 + pushxmm xmm14 + pushxmm xmm13 + pushxmm xmm12 + pushxmm xmm11 + pushxmm xmm10 + pushxmm xmm9 + pushxmm xmm8 + pushxmm xmm7 + pushxmm xmm6 + + pushreg r15 + pushreg r14 + pushreg r13 + pushreg r12 + + pushreg rbp + pushreg rbx + pushreg rdi + pushreg rsi + + sub rsp, 10h ;allocate the singlefunction argument (must be multiple of 16) + .allocstack 10h +.endprolog + + lea rcx, [rsp+10h] ;load stack base that we are saving + call slp_save_state_asm ;pass stackpointer, return offset in eax + cmp rax, 1 + je EXIT1 + cmp rax, -1 + je EXIT2 + ;actual stack switch: + add rsp, rax + call slp_restore_state_asm + xor rax, rax ;return 0 + +EXIT: + + add rsp, 10h + popreg rsi + popreg rdi + popreg rbx + popreg rbp + + popreg r12 + popreg r13 + popreg r14 + popreg r15 + + popxmm xmm6 + popxmm xmm7 + popxmm xmm8 + popxmm xmm9 + popxmm xmm10 + popxmm xmm11 + popxmm xmm12 + popxmm xmm13 + popxmm xmm14 + popxmm xmm15 + + add rsp, 8 + ret + +EXIT1: + mov rax, 1 + jmp EXIT + +EXIT2: + sar rax, 1 + jmp EXIT + +slp_switch ENDP + +END \ No newline at end of file diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_x64_masm.obj b/.venv/Lib/site-packages/greenlet/platform/switch_x64_masm.obj new file mode 100644 index 0000000000000000000000000000000000000000..64e3e6b898ec765d4e37075f7b1635ad24c9efa2 GIT binary patch literal 1078 zcmZ{j&ubG=5XWb`DJB@*%~BA=L%=;Gk}d_~52VO$4J4q2U~MY6&1RFl{E&?scGnt@ zn(9GNy!ihFEO@PV4?T&H9`x2*oO!!jlNJZwd!P4xlX&_;U$Bg3z>p zje>}2kp+MsxE|w5hOUr>YC~(=fz6fwPdZd5+Hlb^P3{;ZO@Yuv96GG&+Gx?QfclNd zhy2KN&~>fNnlHQRR;U1cMyQ?hlQ$~k<0KBbB<0uD2#PTjVo+na7Q;#m=@=3m;xJOa zs2V#)&Db`cY;WzTF9)11;SjkVQWE!?bPTC%x3h3^F2;aBns5!i%m4&-*h69;~AUpZR%rDpm!zuXY+kc zFCz-n*^4&c)5~}y3e?r-Evy*n*(lp9r%ti58Y#l5&)rDjx5EbRd}nC+_8znRzz&#& XZ_Fi+`GM=5Rl{n4%KxAK>jC@)Nz=zi literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_x64_msvc.h b/.venv/Lib/site-packages/greenlet/platform/switch_x64_msvc.h new file mode 100644 index 0000000..601ea56 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_x64_msvc.h @@ -0,0 +1,60 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 26-Sep-02 Christian Tismer + * again as a result of virtualized stack access, + * the compiler used less registers. Needed to + * explicit mention registers in order to get them saved. + * Thanks to Jeff Senn for pointing this out and help. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 01-Mar-02 Christian Tismer + * Initial final version after lots of iterations for i386. + */ + +/* Avoid alloca redefined warning on mingw64 */ +#ifndef alloca +#define alloca _alloca +#endif + +#define STACK_REFPLUS 1 +#define STACK_MAGIC 0 + +/* Use the generic support for an external assembly language slp_switch function. */ +#define EXTERNAL_ASM + +#ifdef SLP_EVAL +/* This always uses the external masm assembly file. */ +#endif + +/* + * further self-processing support + */ + +/* we have IsBadReadPtr available, so we can peek at objects */ +/* +#define STACKLESS_SPY + +#ifdef IMPLEMENT_STACKLESSMODULE +#include "Windows.h" +#define CANNOT_READ_MEM(p, bytes) IsBadReadPtr(p, bytes) + +static int IS_ON_STACK(void*p) +{ + int stackref; + intptr_t stackbase = ((intptr_t)&stackref) & 0xfffff000; + return (intptr_t)p >= stackbase && (intptr_t)p < stackbase + 0x00100000; +} + +#endif +*/ \ No newline at end of file diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_x86_msvc.h b/.venv/Lib/site-packages/greenlet/platform/switch_x86_msvc.h new file mode 100644 index 0000000..0f3a59f --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_x86_msvc.h @@ -0,0 +1,326 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 26-Sep-02 Christian Tismer + * again as a result of virtualized stack access, + * the compiler used less registers. Needed to + * explicit mention registers in order to get them saved. + * Thanks to Jeff Senn for pointing this out and help. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for sparc + * 01-Mar-02 Christian Tismer + * Initial final version after lots of iterations for i386. + */ + +#define alloca _alloca + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +#define STACK_MAGIC 0 + +/* Some magic to quell warnings and keep slp_switch() from crashing when built + with VC90. Disable global optimizations, and the warning: frame pointer + register 'ebp' modified by inline assembly code. + + We used to just disable global optimizations ("g") but upstream stackless + Python, as well as stackman, turn off all optimizations. + +References: +https://github.com/stackless-dev/stackman/blob/dbc72fe5207a2055e658c819fdeab9731dee78b9/stackman/platforms/switch_x86_msvc.h +https://github.com/stackless-dev/stackless/blob/main-slp/Stackless/platf/switch_x86_msvc.h +*/ +#define WIN32_LEAN_AND_MEAN +#include + +#pragma optimize("", off) /* so that autos are stored on the stack */ +#pragma warning(disable:4731) +#pragma warning(disable:4733) /* disable warning about modifying FS[0] */ + +/** + * Most modern compilers and environments handle C++ exceptions without any + * special help from us. MSVC on 32-bit windows is an exception. There, C++ + * exceptions are dealt with using Windows' Structured Exception Handling + * (SEH). + * + * SEH is implemented as a singly linked list of nodes. The + * head of this list is stored in the Thread Information Block, which itself + * is pointed to from the FS register. It's the first field in the structure, + * or offset 0, so we can access it using assembly FS:[0], or the compiler + * intrinsics and field offset information from the headers (as we do below). + * Somewhat unusually, the tail of the list doesn't have prev == NULL, it has + * prev == 0xFFFFFFFF. + * + * SEH was designed for C, and traditionally uses the MSVC compiler + * intrinsincs __try{}/__except{}. It is also utilized for C++ exceptions by + * MSVC; there, every throw of a C++ exception raises a SEH error with the + * ExceptionCode 0xE06D7363; the SEH handler list is then traversed to + * deal with the exception. + * + * If the SEH list is corrupt, then when a C++ exception is thrown the program + * will abruptly exit with exit code 1. This does not use std::terminate(), so + * std::set_terminate() is useless to debug this. + * + * The SEH list is closely tied to the call stack; entering a function that + * uses __try{} or most C++ functions will push a new handler onto the front + * of the list. Returning from the function will remove the handler. Saving + * and restoring the head node of the SEH list (FS:[0]) per-greenlet is NOT + * ENOUGH to make SEH or exceptions work. + * + * Stack switching breaks SEH because the call stack no longer necessarily + * matches the SEH list. For example, given greenlet A that switches to + * greenlet B, at the moment of entering greenlet B, we will have any SEH + * handlers from greenlet A on the SEH list; greenlet B can then add its own + * handlers to the SEH list. When greenlet B switches back to greenlet A, + * greenlet B's handlers would still be on the SEH stack, but when switch() + * returns control to greenlet A, we have replaced the contents of the stack + * in memory, so all the address that greenlet B added to the SEH list are now + * invalid: part of the call stack has been unwound, but the SEH list was out + * of sync with the call stack. The net effect is that exception handling + * stops working. + * + * Thus, when switching greenlets, we need to be sure that the SEH list + * matches the effective call stack, "cutting out" any handlers that were + * pushed by the greenlet that switched out and which are no longer valid. + * + * The easiest way to do this is to capture the SEH list at the time the main + * greenlet for a thread is created, and, when initially starting a greenlet, + * start a new SEH list for it, which contains nothing but the handler + * established for the new greenlet itself, with the tail being the handlers + * for the main greenlet. If we then save and restore the SEH per-greenlet, + * they won't interfere with each others SEH lists. (No greenlet can unwind + * the call stack past the handlers established by the main greenlet). + * + * By observation, a new thread starts with three SEH handlers on the list. By + * the time we get around to creating the main greenlet, though, there can be + * many more, established by transient calls that lead to the creation of the + * main greenlet. Therefore, 3 is a magic constant telling us when to perform + * the initial slice. + * + * All of this can be debugged using a vectored exception handler, which + * operates independently of the SEH handler list, and is called first. + * Walking the SEH list at key points can also be helpful. + * + * References: + * https://en.wikipedia.org/wiki/Win32_Thread_Information_Block + * https://devblogs.microsoft.com/oldnewthing/20100730-00/?p=13273 + * https://docs.microsoft.com/en-us/cpp/cpp/try-except-statement?view=msvc-160 + * https://docs.microsoft.com/en-us/cpp/cpp/structured-exception-handling-c-cpp?view=msvc-160 + * https://docs.microsoft.com/en-us/windows/win32/debug/structured-exception-handling + * https://docs.microsoft.com/en-us/windows/win32/debug/using-a-vectored-exception-handler + * https://bytepointer.com/resources/pietrek_crash_course_depths_of_win32_seh.htm + */ +#define GREENLET_NEEDS_EXCEPTION_STATE_SAVED + + +typedef struct _GExceptionRegistration { + struct _GExceptionRegistration* prev; + void* handler_f; +} GExceptionRegistration; + +static void +slp_set_exception_state(const void *const seh_state) +{ + // Because the stack from from which we do this is ALSO a handler, and + // that one we want to keep, we need to relink the current SEH handler + // frame to point to this one, cutting out the middle men, as it were. + // + // Entering a try block doesn't change the SEH frame, but entering a + // function containing a try block does. + GExceptionRegistration* current_seh_state = (GExceptionRegistration*)__readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList)); + current_seh_state->prev = (GExceptionRegistration*)seh_state; +} + + +static GExceptionRegistration* +x86_slp_get_third_oldest_handler() +{ + GExceptionRegistration* a = NULL; /* Closest to the top */ + GExceptionRegistration* b = NULL; /* second */ + GExceptionRegistration* c = NULL; + GExceptionRegistration* seh_state = (GExceptionRegistration*)__readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList)); + a = b = c = seh_state; + + while (seh_state && seh_state != (GExceptionRegistration*)0xFFFFFFFF) { + if ((void*)seh_state->prev < (void*)100) { + fprintf(stderr, "\tERROR: Broken SEH chain.\n"); + return NULL; + } + a = b; + b = c; + c = seh_state; + + seh_state = seh_state->prev; + } + return a ? a : (b ? b : c); +} + + +static void* +slp_get_exception_state() +{ + // XXX: There appear to be three SEH handlers on the stack already at the + // start of the thread. Is that a guarantee? Almost certainly not. Yet in + // all observed cases it has been three. This is consistent with + // faulthandler off or on, and optimizations off or on. It may not be + // consistent with other operating system versions, though: we only have + // CI on one or two versions (don't ask what there are). + // In theory we could capture the number of handlers on the chain when + // PyInit__greenlet is called: there are probably only the default + // handlers at that point (unless we're embedded and people have used + // __try/__except or a C++ handler)? + return x86_slp_get_third_oldest_handler(); +} + +static int +slp_switch(void) +{ + /* MASM syntax is typically reversed from other assemblers. + It is usually + */ + int *stackref, stsizediff; + /* store the structured exception state for this stack */ + DWORD seh_state = __readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList)); + __asm mov stackref, esp; + /* modify EBX, ESI and EDI in order to get them preserved */ + __asm mov ebx, ebx; + __asm xchg esi, edi; + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm { + mov eax, stsizediff + add esp, eax + add ebp, eax + } + SLP_RESTORE_STATE(); + } + __writefsdword(FIELD_OFFSET(NT_TIB, ExceptionList), seh_state); + return 0; +} + +/* re-enable ebp warning and global optimizations. */ +#pragma optimize("", on) +#pragma warning(default:4731) +#pragma warning(default:4733) /* disable warning about modifying FS[0] */ + + +#endif + +/* + * further self-processing support + */ + +/* we have IsBadReadPtr available, so we can peek at objects */ +#define STACKLESS_SPY + +#ifdef GREENLET_DEBUG + +#define CANNOT_READ_MEM(p, bytes) IsBadReadPtr(p, bytes) + +static int IS_ON_STACK(void*p) +{ + int stackref; + int stackbase = ((int)&stackref) & 0xfffff000; + return (int)p >= stackbase && (int)p < stackbase + 0x00100000; +} + +static void +x86_slp_show_seh_chain() +{ + GExceptionRegistration* seh_state = (GExceptionRegistration*)__readfsdword(FIELD_OFFSET(NT_TIB, ExceptionList)); + fprintf(stderr, "====== SEH Chain ======\n"); + while (seh_state && seh_state != (GExceptionRegistration*)0xFFFFFFFF) { + fprintf(stderr, "\tSEH_chain addr: %p handler: %p prev: %p\n", + seh_state, + seh_state->handler_f, seh_state->prev); + if ((void*)seh_state->prev < (void*)100) { + fprintf(stderr, "\tERROR: Broken chain.\n"); + break; + } + seh_state = seh_state->prev; + } + fprintf(stderr, "====== End SEH Chain ======\n"); + fflush(NULL); + return; +} + +//addVectoredExceptionHandler constants: +//CALL_FIRST means call this exception handler first; +//CALL_LAST means call this exception handler last +#define CALL_FIRST 1 +#define CALL_LAST 0 + +LONG WINAPI +GreenletVectorHandler(PEXCEPTION_POINTERS ExceptionInfo) +{ + // We get one of these for every C++ exception, with code + // E06D7363 + // This is a special value that means "C++ exception from MSVC" + // https://devblogs.microsoft.com/oldnewthing/20100730-00/?p=13273 + // + // Install in the module init function with: + // AddVectoredExceptionHandler(CALL_FIRST, GreenletVectorHandler); + PEXCEPTION_RECORD ExceptionRecord = ExceptionInfo->ExceptionRecord; + + fprintf(stderr, + "GOT VECTORED EXCEPTION:\n" + "\tExceptionCode : %p\n" + "\tExceptionFlags : %p\n" + "\tExceptionAddr : %p\n" + "\tNumberparams : %ld\n", + ExceptionRecord->ExceptionCode, + ExceptionRecord->ExceptionFlags, + ExceptionRecord->ExceptionAddress, + ExceptionRecord->NumberParameters + ); + if (ExceptionRecord->ExceptionFlags & 1) { + fprintf(stderr, "\t\tEH_NONCONTINUABLE\n" ); + } + if (ExceptionRecord->ExceptionFlags & 2) { + fprintf(stderr, "\t\tEH_UNWINDING\n" ); + } + if (ExceptionRecord->ExceptionFlags & 4) { + fprintf(stderr, "\t\tEH_EXIT_UNWIND\n" ); + } + if (ExceptionRecord->ExceptionFlags & 8) { + fprintf(stderr, "\t\tEH_STACK_INVALID\n" ); + } + if (ExceptionRecord->ExceptionFlags & 0x10) { + fprintf(stderr, "\t\tEH_NESTED_CALL\n" ); + } + if (ExceptionRecord->ExceptionFlags & 0x20) { + fprintf(stderr, "\t\tEH_TARGET_UNWIND\n" ); + } + if (ExceptionRecord->ExceptionFlags & 0x40) { + fprintf(stderr, "\t\tEH_COLLIDED_UNWIND\n" ); + } + fprintf(stderr, "\n"); + fflush(NULL); + for(DWORD i = 0; i < ExceptionRecord->NumberParameters; i++) { + fprintf(stderr, "\t\t\tParam %ld: %lX\n", i, ExceptionRecord->ExceptionInformation[i]); + } + + if (ExceptionRecord->NumberParameters == 3) { + fprintf(stderr, "\tAbout to traverse SEH chain\n"); + // C++ Exception records have 3 params. + x86_slp_show_seh_chain(); + } + + return EXCEPTION_CONTINUE_SEARCH; +} + + + + +#endif diff --git a/.venv/Lib/site-packages/greenlet/platform/switch_x86_unix.h b/.venv/Lib/site-packages/greenlet/platform/switch_x86_unix.h new file mode 100644 index 0000000..493fa6b --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/platform/switch_x86_unix.h @@ -0,0 +1,105 @@ +/* + * this is the internal transfer function. + * + * HISTORY + * 3-May-13 Ralf Schmitt + * Add support for strange GCC caller-save decisions + * (ported from switch_aarch64_gcc.h) + * 19-Aug-11 Alexey Borzenkov + * Correctly save ebp, ebx and cw + * 07-Sep-05 (py-dev mailing list discussion) + * removed 'ebx' from the register-saved. !!!! WARNING !!!! + * It means that this file can no longer be compiled statically! + * It is now only suitable as part of a dynamic library! + * 24-Nov-02 Christian Tismer + * needed to add another magic constant to insure + * that f in slp_eval_frame(PyFrameObject *f) + * STACK_REFPLUS will probably be 1 in most cases. + * gets included into the saved stack area. + * 17-Sep-02 Christian Tismer + * after virtualizing stack save/restore, the + * stack size shrunk a bit. Needed to introduce + * an adjustment STACK_MAGIC per platform. + * 15-Sep-02 Gerd Woetzel + * slightly changed framework for spark + * 31-Avr-02 Armin Rigo + * Added ebx, esi and edi register-saves. + * 01-Mar-02 Samual M. Rushing + * Ported from i386. + */ + +#define STACK_REFPLUS 1 + +#ifdef SLP_EVAL + +/* #define STACK_MAGIC 3 */ +/* the above works fine with gcc 2.96, but 2.95.3 wants this */ +#define STACK_MAGIC 0 + +#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5) +# define ATTR_NOCLONE __attribute__((noclone)) +#else +# define ATTR_NOCLONE +#endif + +static int +slp_switch(void) +{ + int err; +#ifdef _WIN32 + void *seh; +#endif + void *ebp, *ebx; + unsigned short cw; + int *stackref, stsizediff; + __asm__ volatile ("" : : : "esi", "edi"); + __asm__ volatile ("fstcw %0" : "=m" (cw)); + __asm__ volatile ("movl %%ebp, %0" : "=m" (ebp)); + __asm__ volatile ("movl %%ebx, %0" : "=m" (ebx)); +#ifdef _WIN32 + __asm__ volatile ( + "movl %%fs:0x0, %%eax\n" + "movl %%eax, %0\n" + : "=m" (seh) + : + : "eax"); +#endif + __asm__ ("movl %%esp, %0" : "=g" (stackref)); + { + SLP_SAVE_STATE(stackref, stsizediff); + __asm__ volatile ( + "addl %0, %%esp\n" + "addl %0, %%ebp\n" + : + : "r" (stsizediff) + ); + SLP_RESTORE_STATE(); + __asm__ volatile ("xorl %%eax, %%eax" : "=a" (err)); + } +#ifdef _WIN32 + __asm__ volatile ( + "movl %0, %%eax\n" + "movl %%eax, %%fs:0x0\n" + : + : "m" (seh) + : "eax"); +#endif + __asm__ volatile ("movl %0, %%ebx" : : "m" (ebx)); + __asm__ volatile ("movl %0, %%ebp" : : "m" (ebp)); + __asm__ volatile ("fldcw %0" : : "m" (cw)); + __asm__ volatile ("" : : : "esi", "edi"); + return err; +} + +#endif + +/* + * further self-processing support + */ + +/* + * if you want to add self-inspection tools, place them + * here. See the x86_msvc for the necessary defines. + * These features are highly experimental und not + * essential yet. + */ diff --git a/.venv/Lib/site-packages/greenlet/slp_platformselect.h b/.venv/Lib/site-packages/greenlet/slp_platformselect.h new file mode 100644 index 0000000..4945648 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/slp_platformselect.h @@ -0,0 +1,75 @@ +/* + * Platform Selection for Stackless Python + */ +#ifdef __cplusplus +extern "C" { +#endif + +#if defined(MS_WIN32) && !defined(MS_WIN64) && defined(_M_IX86) && defined(_MSC_VER) +# include "platform/switch_x86_msvc.h" /* MS Visual Studio on X86 */ +#elif defined(MS_WIN64) && defined(_M_X64) && defined(_MSC_VER) || defined(__MINGW64__) +# include "platform/switch_x64_msvc.h" /* MS Visual Studio on X64 */ +#elif defined(MS_WIN64) && defined(_M_ARM64) +# include "platform/switch_arm64_msvc.h" /* MS Visual Studio on ARM64 */ +#elif defined(__GNUC__) && defined(__amd64__) && defined(__ILP32__) +# include "platform/switch_x32_unix.h" /* gcc on amd64 with x32 ABI */ +#elif defined(__GNUC__) && defined(__amd64__) +# include "platform/switch_amd64_unix.h" /* gcc on amd64 */ +#elif defined(__GNUC__) && defined(__i386__) +# include "platform/switch_x86_unix.h" /* gcc on X86 */ +#elif defined(__GNUC__) && defined(__powerpc64__) && (defined(__linux__) || defined(__FreeBSD__)) +# include "platform/switch_ppc64_linux.h" /* gcc on PowerPC 64-bit */ +#elif defined(__GNUC__) && defined(__PPC__) && (defined(__linux__) || defined(__FreeBSD__)) +# include "platform/switch_ppc_linux.h" /* gcc on PowerPC */ +#elif defined(__GNUC__) && defined(__POWERPC__) && defined(__APPLE__) +# include "platform/switch_ppc_macosx.h" /* Apple MacOS X on 32-bit PowerPC */ +#elif defined(__GNUC__) && defined(__powerpc64__) && defined(_AIX) +# include "platform/switch_ppc64_aix.h" /* gcc on AIX/PowerPC 64-bit */ +#elif defined(__GNUC__) && defined(_ARCH_PPC) && defined(_AIX) +# include "platform/switch_ppc_aix.h" /* gcc on AIX/PowerPC */ +#elif defined(__GNUC__) && defined(__powerpc__) && defined(__NetBSD__) +#include "platform/switch_ppc_unix.h" /* gcc on NetBSD/powerpc */ +#elif defined(__GNUC__) && defined(sparc) +# include "platform/switch_sparc_sun_gcc.h" /* SunOS sparc with gcc */ +#elif defined(__SUNPRO_C) && defined(sparc) && defined(sun) +# iiclude "platform/switch_sparc_sun_gcc.h" /* SunStudio on amd64 */ +#elif defined(__SUNPRO_C) && defined(__amd64__) && defined(sun) +# include "platform/switch_amd64_unix.h" /* SunStudio on amd64 */ +#elif defined(__SUNPRO_C) && defined(__i386__) && defined(sun) +# include "platform/switch_x86_unix.h" /* SunStudio on x86 */ +#elif defined(__GNUC__) && defined(__s390__) && defined(__linux__) +# include "platform/switch_s390_unix.h" /* Linux/S390 */ +#elif defined(__GNUC__) && defined(__s390x__) && defined(__linux__) +# include "platform/switch_s390_unix.h" /* Linux/S390 zSeries (64-bit) */ +#elif defined(__GNUC__) && defined(__arm__) +# ifdef __APPLE__ +# include +# endif +# if TARGET_OS_IPHONE +# include "platform/switch_arm32_ios.h" /* iPhone OS on arm32 */ +# else +# include "platform/switch_arm32_gcc.h" /* gcc using arm32 */ +# endif +#elif defined(__GNUC__) && defined(__mips__) && defined(__linux__) +# include "platform/switch_mips_unix.h" /* Linux/MIPS */ +#elif defined(__GNUC__) && defined(__aarch64__) +# include "platform/switch_aarch64_gcc.h" /* Aarch64 ABI */ +#elif defined(__GNUC__) && defined(__mc68000__) +# include "platform/switch_m68k_gcc.h" /* gcc on m68k */ +#elif defined(__GNUC__) && defined(__csky__) +#include "platform/switch_csky_gcc.h" /* gcc on csky */ +# elif defined(__GNUC__) && defined(__riscv) +# include "platform/switch_riscv_unix.h" /* gcc on RISC-V */ +#elif defined(__GNUC__) && defined(__alpha__) +# include "platform/switch_alpha_unix.h" /* gcc on DEC Alpha */ +#elif defined(MS_WIN32) && defined(__llvm__) && defined(__aarch64__) +# include "platform/switch_aarch64_gcc.h" /* LLVM Aarch64 ABI for Windows */ +#elif defined(__GNUC__) && defined(__loongarch64) && defined(__linux__) +# include "platform/switch_loongarch64_linux.h" /* LoongArch64 */ +#elif defined(__GNUC__) && defined(__sh__) +# include "platform/switch_sh_gcc.h" /* SuperH */ +#endif + +#ifdef __cplusplus +}; +#endif diff --git a/.venv/Lib/site-packages/greenlet/tests/__init__.py b/.venv/Lib/site-packages/greenlet/tests/__init__.py new file mode 100644 index 0000000..e69392e --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/__init__.py @@ -0,0 +1,240 @@ +# -*- coding: utf-8 -*- +""" +Tests for greenlet. + +""" +import os +import sys +import unittest + +from gc import collect +from gc import get_objects +from threading import active_count as active_thread_count +from time import sleep +from time import time + +import psutil + +from greenlet import greenlet as RawGreenlet +from greenlet import getcurrent + +from greenlet._greenlet import get_pending_cleanup_count +from greenlet._greenlet import get_total_main_greenlets + +from . import leakcheck + +PY312 = sys.version_info[:2] >= (3, 12) +PY313 = sys.version_info[:2] >= (3, 13) + +WIN = sys.platform.startswith("win") +RUNNING_ON_GITHUB_ACTIONS = os.environ.get('GITHUB_ACTIONS') +RUNNING_ON_TRAVIS = os.environ.get('TRAVIS') or RUNNING_ON_GITHUB_ACTIONS +RUNNING_ON_APPVEYOR = os.environ.get('APPVEYOR') +RUNNING_ON_CI = RUNNING_ON_TRAVIS or RUNNING_ON_APPVEYOR +RUNNING_ON_MANYLINUX = os.environ.get('GREENLET_MANYLINUX') + +class TestCaseMetaClass(type): + # wrap each test method with + # a) leak checks + def __new__(cls, classname, bases, classDict): + # pylint and pep8 fight over what this should be called (mcs or cls). + # pylint gets it right, but we can't scope disable pep8, so we go with + # its convention. + # pylint: disable=bad-mcs-classmethod-argument + check_totalrefcount = True + + # Python 3: must copy, we mutate the classDict. Interestingly enough, + # it doesn't actually error out, but under 3.6 we wind up wrapping + # and re-wrapping the same items over and over and over. + for key, value in list(classDict.items()): + if key.startswith('test') and callable(value): + classDict.pop(key) + if check_totalrefcount: + value = leakcheck.wrap_refcount(value) + classDict[key] = value + return type.__new__(cls, classname, bases, classDict) + + +class TestCase(TestCaseMetaClass( + "NewBase", + (unittest.TestCase,), + {})): + + cleanup_attempt_sleep_duration = 0.001 + cleanup_max_sleep_seconds = 1 + + def wait_for_pending_cleanups(self, + initial_active_threads=None, + initial_main_greenlets=None): + initial_active_threads = initial_active_threads or self.threads_before_test + initial_main_greenlets = initial_main_greenlets or self.main_greenlets_before_test + sleep_time = self.cleanup_attempt_sleep_duration + # NOTE: This is racy! A Python-level thread object may be dead + # and gone, but the C thread may not yet have fired its + # destructors and added to the queue. There's no particular + # way to know that's about to happen. We try to watch the + # Python threads to make sure they, at least, have gone away. + # Counting the main greenlets, which we can easily do deterministically, + # also helps. + + # Always sleep at least once to let other threads run + sleep(sleep_time) + quit_after = time() + self.cleanup_max_sleep_seconds + # TODO: We could add an API that calls us back when a particular main greenlet is deleted? + # It would have to drop the GIL + while ( + get_pending_cleanup_count() + or active_thread_count() > initial_active_threads + or (not self.expect_greenlet_leak + and get_total_main_greenlets() > initial_main_greenlets)): + sleep(sleep_time) + if time() > quit_after: + print("Time limit exceeded.") + print("Threads: Waiting for only", initial_active_threads, + "-->", active_thread_count()) + print("MGlets : Waiting for only", initial_main_greenlets, + "-->", get_total_main_greenlets()) + break + collect() + + def count_objects(self, kind=list, exact_kind=True): + # pylint:disable=unidiomatic-typecheck + # Collect the garbage. + for _ in range(3): + collect() + if exact_kind: + return sum( + 1 + for x in get_objects() + if type(x) is kind + ) + # instances + return sum( + 1 + for x in get_objects() + if isinstance(x, kind) + ) + + greenlets_before_test = 0 + threads_before_test = 0 + main_greenlets_before_test = 0 + expect_greenlet_leak = False + + def count_greenlets(self): + """ + Find all the greenlets and subclasses tracked by the GC. + """ + return self.count_objects(RawGreenlet, False) + + def setUp(self): + # Ensure the main greenlet exists, otherwise the first test + # gets a false positive leak + super().setUp() + getcurrent() + self.threads_before_test = active_thread_count() + self.main_greenlets_before_test = get_total_main_greenlets() + self.wait_for_pending_cleanups(self.threads_before_test, self.main_greenlets_before_test) + self.greenlets_before_test = self.count_greenlets() + + def tearDown(self): + if getattr(self, 'skipTearDown', False): + return + + self.wait_for_pending_cleanups(self.threads_before_test, self.main_greenlets_before_test) + super().tearDown() + + def get_expected_returncodes_for_aborted_process(self): + import signal + # The child should be aborted in an unusual way. On POSIX + # platforms, this is done with abort() and signal.SIGABRT, + # which is reflected in a negative return value; however, on + # Windows, even though we observe the child print "Fatal + # Python error: Aborted" and in older versions of the C + # runtime "This application has requested the Runtime to + # terminate it in an unusual way," it always has an exit code + # of 3. This is interesting because 3 is the error code for + # ERROR_PATH_NOT_FOUND; BUT: the C runtime abort() function + # also uses this code. + # + # If we link to the static C library on Windows, the error + # code changes to '0xc0000409' (hex(3221226505)), which + # apparently is STATUS_STACK_BUFFER_OVERRUN; but "What this + # means is that nowadays when you get a + # STATUS_STACK_BUFFER_OVERRUN, it doesn’t actually mean that + # there is a stack buffer overrun. It just means that the + # application decided to terminate itself with great haste." + # + # + # On windows, we've also seen '0xc0000005' (hex(3221225477)). + # That's "Access Violation" + # + # See + # https://devblogs.microsoft.com/oldnewthing/20110519-00/?p=10623 + # and + # https://docs.microsoft.com/en-us/previous-versions/k089yyh0(v=vs.140)?redirectedfrom=MSDN + # and + # https://devblogs.microsoft.com/oldnewthing/20190108-00/?p=100655 + expected_exit = ( + -signal.SIGABRT, + # But beginning on Python 3.11, the faulthandler + # that prints the C backtraces sometimes segfaults after + # reporting the exception but before printing the stack. + # This has only been seen on linux/gcc. + -signal.SIGSEGV, + ) if not WIN else ( + 3, + 0xc0000409, + 0xc0000005, + ) + return expected_exit + + def get_process_uss(self): + """ + Return the current process's USS in bytes. + + uss is available on Linux, macOS, Windows. Also known as + "Unique Set Size", this is the memory which is unique to a + process and which would be freed if the process was terminated + right now. + + If this is not supported by ``psutil``, this raises the + :exc:`unittest.SkipTest` exception. + """ + try: + return psutil.Process().memory_full_info().uss + except AttributeError as e: + raise unittest.SkipTest("uss not supported") from e + + def run_script(self, script_name, show_output=True): + import subprocess + script = os.path.join( + os.path.dirname(__file__), + script_name, + ) + + try: + return subprocess.check_output([sys.executable, script], + encoding='utf-8', + stderr=subprocess.STDOUT) + except subprocess.CalledProcessError as ex: + if show_output: + print('-----') + print('Failed to run script', script) + print('~~~~~') + print(ex.output) + print('------') + raise + + + def assertScriptRaises(self, script_name, exitcodes=None): + import subprocess + with self.assertRaises(subprocess.CalledProcessError) as exc: + output = self.run_script(script_name, show_output=False) + __traceback_info__ = output + # We're going to fail the assertion if we get here, at least + # preserve the output in the traceback. + + if exitcodes is None: + exitcodes = self.get_expected_returncodes_for_aborted_process() + self.assertIn(exc.exception.returncode, exitcodes) + return exc.exception diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ea614adfb6098a05339209eaf336d138de240491 GIT binary patch literal 9032 zcmb6sM#zeau#KVus^b}+^SCy~7dClf76Tc{h{Sg&-q3}}Vp zWLy=PamFx{8A$DH#kI8`@jA1czs=uHWO6J;no#tg6}Y9TO_uqN54jlhwLlyF9!Fpo{RlCG$m zwAldmL_GwyC%nnJXdQta0Q;gofStT6;ZN2_>nS9d#`oyQu0DAa?`}rC=lU>0(T2Y| z#!JRD!k7cq`8qUyScj@lzU~2~y+xY^YW&G+j}DEW(4p#+_ZhR=e!wihK5LSaO>o<` zX!{SCU9ZoMZWG!oD{PB~e!vO=V}%YA>PLLTZNxVUoeya3X3_1WwFz2-CM0aK1Y8>cTAbWEx88!kRU5^Xf!Q_#w0;VB?P6*ZvPTbjf5%H8c!z@LRc zHl`zF0T`cf4de@pGc|2i^hHsg9FjnQ2R&8E0xoYcOxp zN6XZmCdI0c$XjaKcffwSdeH~KGtcN_D3mu#0mY$rj$^bwR;nw)SuA-v&zyo0cP^We z;?{?b*XdC8nMZjlZ_3jTD%crBVLCDd`~v6;+f;Kxlogc`6(K3Bc3Fu@iaa4I*Hkth zOC(|=2|=YZ>5N2(>za^a8BP*L3H!ksQyD?Ea$HK7;JC0=rQ-=%wZ$aDOHizaASC zZHrUy zzV^;*rELfPr}^OQg_+*DK-uHFdvo^Y;^@boo$vqXgQLHFqU;SWxaM7p@g;BPC;nY4 ztvi=n4;Nbxf6!NI?Vjr^ckG(8EpGpXd)0wj4y`+pxBhN^How?=FZf>H2PaCNrwZ&- zYp^xw2(!w6<~5RMZa~>r+{sB4ht| z|IZJfAGvf!!a@?Sm1E31MCK2`xfg)%LH#>Hw$M0qJYJ?jDvW;po;8D}O)#%kqg48) z=^81gs}igj60YkJm`~h|nneM`m;_yf<%tx1w7g5fT69BOp1OVx=oEyNyn0{tDgUG5 z*WdJ2@+Le(`uX2{Ml%`Ts|56wc&g@3)mBp;oSw}m)U^tQYF04kO)z%T*{Wl0NNLpf z(@##JDYO|Y5_M;E^R60RpilW8%(yr2Ucn4?=jU7R9cCiA`XMl)p@f(em5?wQ7X)75 zyFeLSlY|&AcZXh#i3(UxVz<+i&nzyEYD_O z*fIFwk>!(v#gl^tw!PeO>|sX~H$;mkqqrduTn-#B29D3z*XxnZJu|+<23G>XU%s%& zFSnm6!Y^EOergDXu3N==6fN1uJz^z4eW zZf?(#vu(xW|JjX2`$JFXiZ@Vb*tg`}Pk@7k!vp1pmZi1>rM5%sG*x%xbKGwV z!_6l?^#)d0&s(&c zgF^#46BL-CG^@gQ$8AP=lhmphPRKwfcDrK6g-YjpZs##MONoF4Xnp&VJbSGd&Q`B$i3F^Ly zSPAf{r4Cr?KCPO%4ye?mYQ8RloM1eJLbo)Yw4K7f#AHS~oeLX0NE{vA|L!`KNP|}- zpYAe-V#^}$fa=>np>Kg5k-5?RS#Z}}&x*fsk^1GaMSlLwI)mzbp9FXPuZ-{YlVB^g z;j$RvsOVqRA8rHl*JVIajCc<^+MBzOG^FF@&m4y z!3%7M%DA52{#l@Nj#}{q7dsY*mOPzsJD2;DKxgH4O)V5SCyW$JjR{1RsI;6-O8Dks zvxKiGorg-b3zMKyI7|kW;s|C!S3@C<6s`?u&oyjK4j$H#uRsNeU$-D%8^)p0pC(O-!ofzdIJWqhUz zGCdkHb(dGpH9dw-qvs#+Ol+8eky-FQmpvUtPshLPeJ@+`94)X%2}-s`#-Cu;udv#I zr&eaEJbDXwTUQ$3AsDKqrVU#%QuMYw;xLLysYXOKz1RSf0;o4UCcO=!Dm2bk-*gCC zw}`29(hwhUi`c1VSHruTLiedi*bb3*HX}&z5R@w!33p4!aD_#g*i-2UhR)#X@1Rlx z2A*r}J!mLQFxAFEOb&4q$H|y?DoRPh?45HP1S6Zh4sG%aP-%Q`bI)35U3WYytnZF< zW&4w*?Z;=#OKfOm&)L$Ra~RxRW}VCIt|GhZp0d3AOmX*_-_!>?SfW=n$^}S zRTP7ggqy${)hU9#MTlcnr+i(^3<)vmTzVpPK5S8~kjMbfNzxEch(YKu1naA;QW+_| z2(KFuJq!&wBd5@%5BwP(hf`aC>lKG@?#N>Mdx0g#6J@9G)4zh$71lLtEwW7?v(1~) ziRnwwiD`&a6Ff>_Rd47FxiwF1g)Rq#G+QCefksUbu9yZ9UwHy*B)nXhCdM^^x3d8O zXhcAbprEHMvN)ECB~<#wfrx4y9O&;kdwGZegMIxkz-*$hUxC@GOLH6ro)acTrD9bo zDrO(f9vS_Tpk$>~Jk1L-aq(g!X-R>387UnXWI1=#VCNq)?H6ze`7Bho&>z^q*B2<{ z3#_`3yZ-Jgv#-otgkanNUDlv|#8yS8zvwxb(5N)CeS4P z5}KgGbZiDh(J%>@3Fe8VsO0@Z6{PQ$Lstd|Lt+Xni6Y35Y}D;gR+d8|*qs|Ok)(S< z=~U=BF_oR%7fQzB7YFx+UIa^(o{+mjJqbA-x}E|_3&mt(fzB%_@ztyl8Wfb!pqLXn z_rU>RMfhRUmK2g{X(}{vO^jc|ZCP!!k`Bd;B`Sv`#!nkKkItDyFl>BC93^Y% z<0fLTwjd?NR16r)SVj`Zt|=inU(NLf@J#JAsk8#7HIpISh%M^Xs~I_~h>5FLD@T@M zBIK*^R>qp$5C?W&g+oI$CM#WoMBT{BRT3X&a70$M$hkU<%njQ_AS-6kc2TXDGyzb( z8cw*;Y$5@fr_r=Z!$j5H1A0pw$tpshB&8*l)pu1{eOoa3#9B~-ro40$j|HiM91fPM zG4YS}{3kG*d;uyj@lCYtX==qETsS>{y5!%!>_1ZUA1V2tT=sVt{oMs;_qQvawyzL{ zNBNqUecOw^?S&o3O1|SC#tP0ee_5q**LQL~EceFVF7$7<9v}T54LvUUBNqeU)&a^t z1H&3hkFF}ctrXt4;T`BQQtMi6Im58iH8bow{GejDAaJNi^)zI#AUkVhWAu@*Pc^H$ zMeZeU9s_BFnK(cFSb3k;?ID(T7=sb?SOM9;FwH=~b+(#~;LZB^z*oX<7%4oHH|wX} z&~9XyYg-{pjgxqfl`Yq`R$JeI&t22ZO{PY(u$lqMFgnB5-nv@AvrFI870Tu#3g4TWA=w#kQvC1R9I9srDfHei9wdxJf4Q{ z1y){^NWvJBnxn87PGo9{;&fKYWEF@ZrXV{lObYR=LUPiU!J%^(uMDZaUT~oWz9Lyf zZX|53Rf{$=Y|#Y9p&g5)OjU<`Ej__$1Eg2UXsuf{36nC`+nRFJf)P91imTkpZd^8bkZ+GnQ4m!{#gd z+m`)%ivB(C_x^k2e&oaRg}uGyBPYv;PAwnmEgtG!Wl;UzHDs#qqgIj0)kl2`$qsMx zvS(k>v+pZpwfR2rG(*B+ZtQKhmVkI~bjf?P+A=q?AkK?R-VkoO_O_?&tozHV2j+bz z2jRFMS@-uGMIRmY^t$Qan|qjE8~tB423|JEEyf11jIA5w_ItcMdMlaK`Rpj!t5>NTer9*V{2GbICrJIX5PxOjvMl=kAv93 zh_LY&nXP7Fi9QJ7)dYN)d2g588?nAKRz2~NErDVK?9k#LA5 zy^gCmR4S`=4y05Y&NmW!qS~ttRM@I{VAFUo3=tLLR%t8KFh$Da9v{cyKv5WhV38OU zh$1kWD>h!^W1qIyAdye)IJp*spEq}Y0Sm}eP!YZ^yXux*?L}AnVs3fcsp7U%ORlGW z=ZDnV0yody`}+@tIj$5qH*>z+vAf`G|As;C)2mM83=|x#B#AaqY#M+J*31CJB6nT0 zuDSR^az44-&{b^c`oOltcH_?_)3ejyuzll)$pzO_-^rMm_ZrTc=--=|vkq(66oE|6 zkTeL*;d*HwJf!`&!lAfy6j%7mwC4J^UumABA@9EtosYp^k#N4J5Yv zbosGCmQcam^p)AnJh|>< znN#ca4Ab(JdoR=WRh05DPg851KF0UW9tYD#Tv)QXYK;gJXW=_rcqjf8$EV{QCrS8d zleogiQcYuVl8Yf}7}cgFgh7={I1tdnR?IG1Zdt$(4!opGxWWRb`t;bf%SarP9J7`< zM%vdw=M6~ofOd}StiK3-4TbH}X!Tu=ixC^;7``%k>Ql7v?W4MCK#+j+g59J**!n92h8|x^hF)!ub67 zLTWyBFIs9iP(c2&x8tGrcwy)9Tds0ra3MFJTevxYv#_hX)OfOh>etPF>hz*{9l>LL l-whMhR`i6*Y+cz_w`^-J+M40eW!AoCrM=Ft5$-3b`hR+p3OxV- literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_clearing_run_switches.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..998b4ade1988d328e9bb83a475fd1b54504fee04 GIT binary patch literal 2100 zcmb7FQEwAR5Z*oC`Hr(=rvyp^Jgh2|#1(`VRH>l0QiUp@LI#l_RhFg8`EG5WbG~zT z_W(ycI3iV`FYp!~d2E&blfD>11U;n^QlI)%(oj|EQ)ln&*hEz;R`z&yc4l^FzM1t; z6B8za_2<=J8o#Ru{VF%Zr45+f8H~^da#01j*j0R70a{TML~$!SR380q4%mv?Kow0v z7m=G;L$121qz9F3BGW*Y1rG!1$R451%s^9j^)*y6;3gfu*`eo6h)1r9LY3B3%8%2b zUd5zZ>&W;?%DV&nmzM&LW|9-yXc{+JuyjnRMm9$4k6Hp~m7u2Pz?4G7M>Tqn0E zY1%g_u?dR;;@G}#*L+GkHs{nOA|#?oi4z7~u*eZ1Bk0{wC{PcE%AHK!1kD6Mx)^}YKmjvx?s^nl7?jHys!JELE97_gYakm) z08Lj*O7|@nkMI@H+39NOLvHlzj&(v8l``d$!lXg0Tb4_G%UYSNv#?FZ!YZk;4rPpd z!Q-sm>CnK9)wb;gahBimgwrhHSmo5Oa~VJR``ZiWt2a1hylQ(c^LX`I*J;|UeT{`J z>Ih!#uu}~hP-a6TRQ<5Qt2Lk&xVGBS^0^PI^EYX5vwFp=Rky*x<@22`lf$|)HI~QxAVY}-KMtgawvFP0!u>-3$VbnN zGuuY~LGFI8e`sdQnB9eQREE?I%L?o^wXE2*taj)|zU1?k^$oOUdXilA17Z_k!t#>H ziY8_$~VcUv$Rb4(TE3jsTbqbO*b5c@FM8_CI|xhW@Be7LeF` z*;)s{;l6bT{14}TLH10Xfnt}Gm4g?drf*ImI}FApjmeyu0VFmgF!d;K;%r!x4G>T6 zH-a9_NmW(Wlgm5_NelTN@c(wrG|2fpkRE!GD?a@AyU(`sQxD4b%l%`YJjUQz)^Ww~t;>=_5{o>Q&nZ9u*DLo9nK_eCBXpQiKkIXeN$^0DBLfV|3J zjCa&5R(A^sPrg)*9)6)8?cIK^AAO=9eX1YtsV~iZPyb6*@!Spq^16`4XYU!$jp--G z^lJp0KMrF2!H$8n?CSE}_EYsx55F>Dw|;5$(%rAXA=1|itA+mL`;Wiq7iXTK*_|xH g*_~e`7_db-oqnXXgaCmKb*kNfB*mh literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_cpp_exception.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_cpp_exception.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..12edfe417a2b8bfc0f03c54fa65f4ee729b06595 GIT binary patch literal 1635 zcma)6&1)M+6o0e3TJ5f6S(S}R9qcY{8=|I>>p%~2g273O9lN+GxQD2M&00H_S6=Ok znUTMUK`jZ5p^!ii$)C{T{1ff97b|IzyiK6cQ*MskK$}x%R#GcsA3Csa=FR*1&HLD& z`}z#v>(yt^OZzgwAA;$wSm$tb76Cj22lC(`NAge}MZ1)j_%3^LMae4&B)~C8+2y)o zA#h@MAg^LnPPK1(siVHl*}SF;D;+CX+m+h#yb<})u;J*Bja`mOtjN2u+h#boDZL9g z@g9(C2(X6L@~MufXIniBKxC}u4SyVKPCVkX+`Cj(dek~ctdxh3-*#V;wp0k-()K!SU2sZ zfH2A#Y*tB7#FXX?W6@s4)C_!V+N4ygV4r;$Y4~;po56B)UatAY$dBurla;`kyk&_< z7T#dkr#ygFtX6NCEHI0<=jDtS0{cQ1g##z(ZH+A3t|u(GeHWlhO;YoHj=k9XZcz~N z9W8Rgn*!Z|ZD5_E1C)DpJLlWbP2)DYjmpCMjnz|F$Vv;x0uFHfqd86<_J-SlL^7O+8D#(@b7!Brm;^CEXx8mu96< z>jDYYc9OCZNpMjpl_sbthiMY=KM6nh|3FATH%Ri2j&V|lLrIPqe`;W4n)+}Y}n39~jKSII&&I8+VcSdu-XO(UojEj9a{# zMav3hx=D!$7^b?0xhSvgZirQh>$3<|sBnL4p)Q8a64MvPxqF*25-Q>@OilB%yHsQN z6G8$KYF4DigPc0CUwE^Gs6<46yKu+!H<5 zN{-x{Z6-$=$&tO$iRS2BV|4Cma{eA_^{4M|>}>2PziWMeAM|rSuW5$keXLJw@S`@Z MUU^IYDUCS&2Rm@55C8xG literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_initialstub_already_started.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..202eeed35f8e5639568d6244033247d1a68d862b GIT binary patch literal 3503 zcmcIm&2Jk;6rWkI?e$lj#HAleT(%V?u|xu-YH6ziN>WN%z7R}#hCnqvyZBuxbB5zwnhb50@61t&pveOq!^oS4_#>4u%sK0AHpP7mz# z?z7Vm_Iio5gey7(nEQxu-&f^0fa50~;#jKK788k>Zm+izq3Rbl5qJ8@zpiV3(ljF2 zaxwa6DX`vHN`MGyxq+q z*luZuxU^_3#BIj~qj4e9T0G~yLUfkOCgoH%#ZqcUXN6&zU8A}8IaAHbYK9V38<%ya zQbshH+(?i-OXae?-e0+6qX|y!Cc*$}0qyhwxr3O^N9jslRv9qR@C2%j@i>YI(V}~R zBvV4rt~*e_l}Y5Sp4oY;J|&OqhOXg7G2fdMA()+N}8D%&HjP z6rIyUlS4D_u8Ie3{^>Qb!xZwEYbrQ{cKjgZ4k8H96UBsa47q{(qxT$!q$pW+lqibf zRg}@3R><(NUs2vGs2OX82H^0XfwY-VIq86|bC~+5vdo!{_4BQJ`Zdha8_-xZk=Z#e zMw|v7xR9vDW9|$ytlz>{+(8pq!`Hh(^EVSH4NLV+|C;gLW=mHCYjgJSlDTYN0gUIE zqX`p8v6+b3HxEkts?6#@b1?1=v;8}Lc50+~KnX;En;ji*R5N|KbnK4b2YSzEnLm@Gnkn zS=MZX+Goyh2A^0Db}k1y7unq_E5W|9)MtT+4IE%U;>BcMNgu;te|(+5wO7(U$XScA z)uL^P#(#&g1I5Eu2FMnc@>>^ji|0oLeFq*xU6HSt;f@IO7<`f8;5Q;i9y_E*U|f_S zq-JLIz)XJz2!OB@oNJnGTJS8MC?D!tmAWg8@}cKfrM^wcKj)kE%@3_fVbhDzh|9__ zUe1(P3vJ^>=7cM$N7jR!$H`IXdJB*#v=KZ|8hRx7oF{hL9L}Q_4)Z;YfwmFQ4@N1M zRj;j!^Ely84V_;}piPu44V(|J1y^3>wNvz&^=6i9qUi3IHF(mz3@;6P0N0zz3DoTC z?JG*}ymI;K>sKzHjkFqWMbUBzMWOsLYhcx?yD&^Bza8jPobVhlp8%A@rFGSqUNMce ziqv}3Sa+z%)f&z`O=Vf#_ZiYT>ppvl_JS;)(fSFX+YXHJZ-Riu9SPy)Em10A_-vcF z+e$aq-EGV6wiS0rN!<1$U!dfEBnr6mk=KF4yIzEk%}DFgk!9(~Dw21_R(#Z+?;@D& zc4O?>)NAITL}uRp5Qf_l^7`fu&mO+jR&s41_jJ=_(|llI ztQ_oIMP1vVPMDS^r77=LWzDnj{AZ^=J+*k|uKHl)-pE&}Z(F`U_}#&BaA*}>+;$nqoVU?JuCtou2zCY&8d++mk1u*#b>Z8*u0q~hK z0?;YZ{>q4LV1pvCp)L8a2ql0eJ7uGH>0Rc<0RjgUQ?|SYiU>om6Sb=mx0e@Gf-%~K zU9OnH8She}5!CJ}0Rc|g83)b|13;x0U={w2y`6QW#KT57W8_5SKl#@rEw}hsd7?&` zMrs-RAtq|6LR5;e8#wAh*<@lf3~@jig9DZNp+Ohi$SMzOO38G6I;OOEy29cO&Kik< z>Qa?dgMbBkt-&~5@~gCLiPAVuou2kR)}d_>o#{NTIR`creS{!N3#BIuD#4(97M4knqA!e$+w`*-~D~@=>vV5VnTJ(wTVmhshU+b$=npFc-V@l9+FW92bh>q zh3J08q52HF4VKH8tIpoPtB=j&U|xUe&gj&Q@MvgSv!;WoE~*&kb4JI{4a!(pi&3c> zScEUf1$O8gcGbZV%5F@qOm4xo!V&6iqJah)*hkl!NNpgsiG~_z=m2T|XtiD-7g=<| zM~Lw0(Udr27X_z@XoEdN5f!mi^KgzyBVAZqsl*moiWDDTO)ckX-u zVxmc1=0V^lZURy1KLnF4vcS h6>m*!&aW=-fot{U!<)D2@Bj=RvosR-Tvs|J{s2%W5~TnD literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..70860df0a22c629b0d3c1081ee8e602c2ae3b580 GIT binary patch literal 1744 zcmaJ>-)kI29G}^n-P~=iHr=!rYSXe2VmLJyTPUK4QriT?5KE~dVPVW*KsUjq;#}_%ibq75}ifuxjI9AofOq7qtANr`x+{e>8BG5jGkkW zInr3s@@DG?^CM2V?b(8PMQSfK!=ec4p)Kk*zZZyN*)B0k!zvY^B@p{^o0Fu_C1<7SYq{>QYkhWqoL?~ltH|(4%W;}qJUvJfT(eB%FR9b?1j1F z;OhwpL$D63z#byeD>nk*O87qd5&vR*hcFWT!n2&Od00q0MHOj%g4TO7*d6&x4fCwUwZkCix=-tB+C zy8e~}rDxpn0-pukxw%p-d#rYo)hke7?ljnRiH4MUqRyOZy~Le6z+JD=aBI!GZ@%sn zmT9=`%m;TI9tb+!@QQc666H=(${9hq;4@2JP<4}}$^fRDDDXmKCCVt^CGKn(5_2&mgFFGHk{&#bzbi7|6O`zGb_~R$hy&1)`)Iw_AQ%C(`a&xM zyq{xW9GYf;==J*!5C=r={bm1|XWLfZW3=a8F1&0G4gK$*(GXfVqN{U$N&r5OxApP&; zKpF8uo-o-(?6hR^|ENmvGg4V4kG>+S%+A5>C0P6-ur_*1vRyLPA!E>RU1E2L-6c~U zGWD3`mGPb&omTce=yW>>?V1;adout0a5Ut)e!b|rDm0AUWhN6<_^7^C^;PkrG^au} zy~-=b@vKyqRg3dWzg?^Q%_@C|U4Szgm45+jKZP;=ThlQ)%pyFpt7qEUwq(1f&$hD% z#K12dj2QUkgAonCvY$rSYNxyCOb4A=%Wt9aT|L+Sq^svTdTwobQ@Fsa}o!drQeDq~jCHWuip>I$C literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_three_greenlets2.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..caaf1dbfaa534a458c8bfdcca559b455b66b756f GIT binary patch literal 2598 zcmbVNU2oe|7(RCVkuRsK(~oUzojWL11WntZT`(c0v9&O@D*I>wMUf)cK6R6(PIT;a z)Y?!ckXmjacPn?(?$Cs^U$8&GO`-&)SVgJ?TyQs9al;Lq529U~&9#rQExhEKnGzvIAbbHoqA@BL5>0^C@zE1$s`N8h@+hetZ5`k>~ zOb?GBjI7Wej&mMC4Z+A0_e>Nx2084#lRgeP(gQjA63D`d$g!iyFwpDnPu$BMd%nJ- zC^*W3dJ3|gn{U#IerqW_pId{{ikvHCjk`HhSO%%C^VN4!zzsj?me_{|O? z*NwOd68wVAnn+e4B3iN8#oJe}&CFW;T1r|$#dXQqTPf>`6%EbLT>WH5ay$~8%_C@( z3#MUna;XG$)n-cwhs}<90WM~>luhH#wO109&B#bI43am}-&@x%XO;|zjEtO9QO?NR z+*DR&w0;v6^H4F3ObJbBP=`o1izrhlYDQ)m+bsTCcD=mz?o=kZ0ric{d~P{o#1aE(+>G}L@|6a(v4YcDqxR^Y%M%ksD8M!_-ORIPiyh9 zCiCVV6WSiHF=wjR8_b#C`S|Yex$Wp)F#K)k>rhP`YX%*U$r>}dbG^xo9%3Y*xTS)O z0VzjB42LyrUPdCvh@&gvO(Hp`<$Y0jD*$*&ly^#GXPu1l!qGXIsR2(q_o)*E%-o~8 zPq)b?xCM*TrX@_Y6}q9jIb=l~F|`xQis5}{UXl^iO^e5KwWz}ckBGz(xeOxru!A0z zc36X^Qbxqz=GyNeqWT1F2k^IS=L6aHhC!q(Nr+s{#)lzUjE3-J7RU}_Xiq%b636P|SVJ6diOIT{Y>AiZ;-#nS4e@$q&Q(Nh;EhLXwRoz@yt5k_ zKz$gpH^tBJ&Z|?L_cI>DxXmZC2hlz2fG?B#6#mO`uSRIfA=G6tMFKjDX>@CZPh;x8 zH1^|TBl7!1abgH%D1=RdMg!jJ3w$~7=rrCP!QGg{rUHI*Q_<&37;FhrU62~W#g>q$ z3yGF6RTrk7o^J?ODzp3X)0O!yvQ}#Gi6)cu$g-lI1lQ%9Zt=uosanwwa1Fu5UvieC z-UYjzQdWG~b&{ReWQ{=hns(MwR>*m3(@B4r!o%S0nLA7Ki+3(3Vm6=6szoK6MI=PH zPEI3|o=$MuX+R2*BU>jHcF=%kyHb-N+SKQrJoz3t5^M`T_}+R^Ef?VXh=h+69^)Tu zo(Cw3`jZY&%wZ5vr}o)Uh2AA*zb{^i?uVll{(#}Biw7c04IadJYVi30pu|eB1^Vlt zznW-*bNlR2<+Bz$RA+~(8x3}ZAiTJ;&v08e9^Ba08_f9%wF~&I*n?O#v@^Z^MH7tt z4A_cZm7C!7?n!<%?zNp;O>n_=ti?te%!LkOWan0`??Mwu?*5l^J@&}w^40O5z*#3i F{{lgF75xAJ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/fail_switch_two_greenlets.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f47754c42805d0632c468d44b7aa8553fef02e89 GIT binary patch literal 1715 zcmaJ>&1)M+6rWkmu0GSsaU#{=rt6f}h}L%PTT3XUi4CU44IwQ>EG!%CXuXQGD`rP_ zElN?qB`K8FxAa(YE1`c$FBVadySN|-J+!CPqL-ffW~7y5)#-!xX6EUA|K94C3l~xd z=&rJr|FN;4P{DCmfHEjf%*|wo=7KkVOSJX2&dIlLJ&#Z55vWZcpGW*{sPlhU)CuNW9F`}{mx8GL^iRO=~ zPXik0md=?~qI$XEmALDBI`{Qp&*h~Z-C>k^Rm#DL>kW^7QKuzNZJoO{8Z4($n_#>{ zr~Kd5_h=NL%>0@(DK!|Q9v?*%Ni5F?ZLG_DC-sAUUxgum&-c!Y&eJ31&xUwm?%F?M8geJ4&}pr54E}__MV9@enKoG%*B6E zs12gCi}1(+2iHIhM*mKS5A3@ujY00);qh+ee^oA);lK9)T!JR?`7Pcwf`lA7gug>)DMMMXNiE^ zVmVKlC`<&D%N2ilVTo%s-)>athwL?oBK9Wu3dD;T#`rHq#iXA>INMW`E#+8<-m8~d znNy%<{N{@U!WUbKE}ChhnZrT{&G*z?>+`OfYpc1#-KXjm;XJMBA>~2x Xe)1swD^icNH#$f^9%#N!%OU&=sI6|D literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/leakcheck.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/leakcheck.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..265637c29a3669abd0045b8626b2271eaaada5a9 GIT binary patch literal 11580 zcmdTqZEzdMb$h@81Obo$0e(}IjwDD4`k*9BvaHX9CMlVc41G~bL{mD0xFZD;1n4_Z z5?RvWxSA;#D-k(KOe(fVwCkDBbuy8EbgE1{t&`@5+hisH!Ibb>p3zL)N!1@6T2y9S zPh0oBJ=_5V5hJG4Xw;ylczI|W&c7Ih=WF?UPaPpJBziTGsclers(-<-hn!C*DHU(V;w9e9H5e@w=4Rq$&UzT~- z-URkNMt$$HeT7~ot=Bb1HZVlAb=ki{Z?o3Bt4Oq`Ary5Le+38yIs}L400=dJ!=FB9 zi{9J$6?zrwy-L19FRR|mCD^W$F1KKZywpIB5~1ii5sJmK_l)TkC^rzXLNp4F_kas9 zN!7HS6WW!Cm3q4>Xjk=~+JuM}o=v|Jv9zl?Y!qBDg4)v!JxjBC)=+q5P+Fc2OS}gE@1cX0 zgVfO%jz}UGy)1Hl!7E~zi}du1fhZ>o!}R;Okmw%>TowZZaa{<4sf>dj`tHDr+lZL}vxt`%D1w%{1kto8Fht(kg z77oX)8n2^w^;m(BUzWF0e8q4y2&mH%bqEAD5F8o;#Ma`^bzTn2bnu`Is7A%GpiTgK z4a@M_8SY&M(8Hf8K+Pc5{ zoGeOmw?8OILAm?XNZ_(x8ayRMkQ?OgA!%Em7#1aeG$M6}B7Jgq59B`*jAMAF3wq{}eEcnwPN z37A_es)BY&iby`MQL*rR*gq)pykh0~!H6&%!go8*zclO*sWtBsI*N*H6+o3R6W}l7 za$F}V)}pq+a>d#wMpXqQ=SQp(T4fLu7|_~A!2mfsVg$k#@XtpA14mm|@d)w<<&mwl zb5xrp>DT!KD$+?{wADvF>65St%-$%E$kKXvN5PTBP;b^EC^o>FPoq8RPNUGARTzSf zX^y_Gs6!9(4_}@z6QC9y-mC47M3=9%D4~coy*S0eS^6m_Hho6hmLY zYmhw9Rbg=jWCYD|l>Um1=hN+YK7(ggVHojrKsG_{xvSrJYBrjMrO#`Us-aG*!E7C7 zjhJo0tQIrmCv~Mce8X%2{xWjYb@I@_6gIA~kf{x^deu7Ny3ln(@tjd*kMS2kF%>_w zR&8P+LUj;T*8YqTQhl8*i6~)UjliIR-3fyf>M-P}6a)je>BSdeO>vddE4Rt};)~w3 z1`mft%YhnQMCGijFs?Tk7Gw^TeA;M&T@ulRf;E)It*fj9LcxKXmsO7x_O!^#t6t4`C_NC=q^hWXqf1KE6x?{qbhD_}KOc_AZ2+6cwyQ&DJXo|Se& z;VPB|6%zyv2>iPFiNiN*ZC^$x>a0^`)iL%v*0o}$qqj*#kMzScH;pm8Mje>I*)-Ay zil$PoGXkHsuB)bkVw5`-bO`>`si(r6J{Tr8L2eYtgr@CsVbFN9e}@{Gy<%A9g4D5ucmkfBdA}Kz(Q^oOpq4{ zX2>l<0px{(1#+uU2)S*<>a{6O{*2h$8W|2psWA~Hie&&s*v>ueXqFC7wfd|3^sfcX#Mk5ZFCn zb$?V=iqwS`c)HSxEi8(H%*$f*+>qBuwXU=e#*_9#CL_{%W-Fbusq0mddq^jT6S9S0;c+D)EMi#EdW* zO9J*IO~7%(m?5h?uSL|_4uGUc8w-KN`Rr!DPFff{owCL;jv1qL^N&@-j0E3^6Tm{_ zkdyjRc5;%o*=r*gEx^Dm=o5ArT%j8lhKw*QLAK~eQs<;AL@uUvsD^UV6-t*8V*`om z9-)Uwb<7`|BkGi#l$oPoKnjf;FOVBouaaxN|O+y^Zg@aH{<*m}?J~8o|CP>;Tv*#Vua*LpOC-24jMoCM(P}>WTrY zYRuXK-A3!zGHWj4uR%LG4jEV%E3rGKJd+1f?#g=(_f+evBQbW_PVCO_@1A9sDw`9P z%}Mw61>5#zLqX9==6=)WrKW?4rh`jOt%;`A4_cE=&&8b$%f-am@Z;u$lt| z%Vy##pQ)X$T`Flzlr;WJ$;Mbq%Hf*wfBV`;P-`NtO*pc1YWI@6F#$hY<9z9z(xsiP z3HW(i0h{{{_veoqNooB8n=h!Z_E$B} zy2&rx8=pO7{KY{A@>R|XvO5*CE_lgy)A9+2fDDC#nUkPYXS__+j~Ok_L0wRAv`wMl zU@$5jgf@z~HyDbF5;(gSSlB*@NL*ITeNyCV^fGNA;p#~ZkY&551-#m1v~umTsx^O$ zJ&<9*_j6R-{MO{R<~r{Pe-n8>0)|H=*drt3JiJVp!ozFT4hW@6k2l~2)s76}-ABf= z)C>CQV@w;-L|IcT<3=pK2;Ox!P;{IfH;tRe4E;#moFstS7-PpwW9D9V6ey=bV8{)Q zB?6mQ3F#ZV@q)1eps2|=y6)h)uphSYxMc%78yF7xqY(d~L_EA|nQ_r}!G8r+`fkxNj4pVMnPC8_GM0>xpBS$)nzv&NiD6hzL-P&^_i75muQC%#;X&MG zUmKDRkM3BzP?9(lk)j~_y}iu`LlMASKHRML_$2_8(Kr7$^7#abyZ63terxlbXP%kg z`Tf>ecBbQf^MA@XpI54Cm{EJ$te6;ql^ZEzqEnkFe zf_&sCOSyO6ce-Mxdro%(=aY2rO*;3+Odr>8O4!%O+NK(3%To4|n57*OHhMjfOARIEaz6?QS*2s8xr;n zi}t#dw>j2^C5!f^WrL+~UCLgi7R-8XZ@aZEZr?ZWS+MWB(*)Ult#f_CUcYGf=)gP) zy9WTIyxVkOsSORWwnh88j~rF^oUWO|>B1k_KwmhkKVL2+MI|Z{{}(u4$VD*SpVx7% zjpQF2TN>M~tNjOkkMkeU39E;U6cYfnkXx_0Pv^82mEj-Af17# zHJ(jT+Oy&Pz2Fv&u3yW9s$Ey>KLHRj!U31nOzh=vxNq0os!7;9_w0_F$0v`^S`+q$ zCHwY-efy$)XUbOf#@X91+@%EyB6(xz`49RHaYg{%W+HXV|*eE z-J#>q4+G~W+=8L6lnL+UGbPfxs7_N@MdTiu^0j^4@TTtbyuyqb1fxKz!8;PzKDtGb zilh2QW=wA>nCNy0JTC!GQLABREm+=W1~vi7nGti|9)$zlQ0t1?G;E-+75i#_nZQ1_ zzm4|)I`pz5S3&DGfcK2{4NoJMQyAN{FL)N{rS(8ll(U?aam2txXXsWmW_aBo6ptBS zXWrCLeP3Z#;ZNtDg+D|*^- z+KS7A`4eWldR`E=clkO;xufdA4TKosz(?h?U4un z4aE@Fz>-Y%fW-#?g*~p~8@zluS}uvb)D?ttwSXi-AcclAr3={g3N}L)d4MYcF699% zr53CpjRHLskj_Cl1lorOr5e`0TZvl#L+^sE0SZ2~700f;dSJE=jN3cL zxg+yW&F`8!p5%7iX<6X*NU_x9`*D(P1F;4QhiH6VexWr@neG-WW7&d*8xxIN5C(ORtl1GZzPwfl2T8`4o9k2`aN2l`e; zH|Q`efJq(){B=eseAB2weuY6-J&NaRG(iv!?(~eYGV=<#0B*eQ{#t!h>(CR=Bc0N2 zXsw2iL6Y@^tg{RLD@~B;dv-8+hK~b~UshA{xxDSFqh+aWjmrG!x)sVC5_?JTb06>9T zq@KLfBOw|fR2`@ZY#zo;#*Av?7x3*{m?3q%W_8;?fCYGVDSZPnr8o^ZeUMF+vWzl~ zy8(?vcHm#VfTsGqlzToDelz&1!Fc1vWcj7I^Ac_# z)_?w}5b}q_P+0zvyDsG{`^*Tz$7LgYe?d=jetxiJdz*#)(qeC`F#fWff!yb{=N_#- z2Q-rK)Ig2rQP-E6#mvf0U@g)+_nc=hmSJ`s{xS;5bqvs!RZKkpkS#RTJuGi9l|DSi z7)*yBTCDI|?J%u-SZ^_{e^|QRRJzi`RGD~&>Te2WRYXjWl%O#D#VR#E3ELRBN0C&KCDGq_DuDS#;@iUseXbmA3~ zia&CDj4pC|<1gt#ub9+q`h+NYZg2ZaF|X6g*U%tK!JHRwtpO3ab1DJf!bHMm711>6m2E zD&(b`P`?WiMqvSj?-hXC7O(Km?^!I^`PY2PQ5Gxu)MSl4{pS}~3?|dT6(cdbm+=iw zEbQ(HpNh(Qya>}f9EEE>JTD;&Du#$mx3uYy4Lx3j8(K0&Pr?O~PGP$OxIPt>B4Nb{ zHxiVpGv|ChyaagC$LHKOEXk@$Up#bY6}4!05R0-3TRW7}tWW(?qV!!HAI+2WDrV@q zP*#JZC>gGU;l)RK6h+N~QgGQX(_1EH^~!|AVf$^E;juAgBTC8~g``*xs{8rF(woo@ zMNe*meA&n_%pZ0Trs;R2@MB{Am=yjisri^VR?LKPEaAFeN8oR3@#Q#f_$5rM~NX2RNHyQb`m#@a^~ z*3>xF^oYRYGb?ddf6qJd-1XzB+N}w;`XOsEl|CvpF{Sh7M+6>^iU$pF<6!E_BSK$R ME}86%o3hsb0t&?5W&i*H literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_contextvars.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_contextvars.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1fb14e5d621e192c31cfb1099149af3c8d437459 GIT binary patch literal 15334 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 Y3f_Z$x@ymA@{85JJ=-0>*v3Hozm!96X#fBK literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_cpp.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_cpp.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..29c945216bf9853bae35f2a9a6485ae713aca64b GIT binary patch literal 4112 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 N*Y10W`zfZ!zW^#Zwsrsj literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_gc.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_gc.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5d5abd4a1f7128c543bfac569b19ddd295bf2e23 GIT binary patch literal 4950 zcmcIoU2Gf25#GDw&q+F3r2b4fkwnF+B+9m8H4Yjlv0__Qt)9nry;(UiM+zj}>F}~zqd6w;QO4nXb<^Omoeny^takXQBS)Tug$PBl zmXAz_o_jeInZ69a$mD3)XLzrIjZk&g5RiyTs;b$HsvFHoRgW)Gs%CY=qg_qu@i~J} z#tm;gm&vGc-4L|AX1Et=3K&{|8K%c`OVE%MO;f4+k2W4}MY(?tWQFWX?bn}QfBr+U6bu)G;ZKK4 zBj<`E=eC36rQl>SIJq61+LkV@al2yk_2%{F4e5&(>7B>cp7~Ph+LZ!ZZIAq6;^XNX z)1O`V^ThVR6St+aJEBw)yNhD?2mQZ0ep~D{+rgq3{IKo!$38gr(MumkZ$v*APnThP zQUgSUmI=g@CJ;^E0k}@^I!2=2xzPw{f6w4a~m4%Ql#+fZG6?1)f0wpku=` zZJV&O9fO)__CBYd)j$TG@vt>bUetMA(M8sgMoX$IhmY1lq{d0ILzi*YY9|>L!1eO` zXKSp(HXLSVqfcjYaj^OE(E~$~u*(o-IjbzFvTQWV@3!~6B3e}V=bk!6-ffvd*;@jfh0+df$ju_LN!(|AL5 zm}qaQRxW6R5qo{G98BIC!A^h z8UjCLT09Lyb@|-)Ip8Q;dH|Nt`hY-`@CQr&{-VFXSwQR`A0tY zj~}#Mm}990Pqs<&AYg>{L!FKQsTLEZUw-0yi3!>mg4tyZ8!KeT-(kuT3A<@8^iUL> zhLE5tOf^{|R5_&smrDnM_c;7C%(+&{J)ZMDQ}%GaPRlc4))^Kp&-CC<31>BMN&z!C z+cIF>?*2|qpkvcwK+qMrn>rm=1dVSb;_Ee?(f`d0VN8C@^_F`R5>CkJ>*6wt!Ed{g z1X5Sq&>NXHi;i!**IaAvS$I{fiV$_3IhgI$l`8)v6u5#Q+uQ}NQ94}^s$#E@Zs4bw z6dZYzdsC>|9Zj~bIJ~;;#Tt1mhY!+LS0rA&3_=r2xeZ9YPs;OQVgIR`yPpNS$fTB4 zD#xj!%{dM!H-p)v3|Z}*Y%|q3CEUhzN(_DUB=j`IpW&4ud(6o4^2C3!J9rFpkqO-9 z6cWT3SK`b4BdXl2Dpr+jQ#c_x?0FF*ERwo@}{3YOF6fPA|`zBqAy`^3eK zOC_nVDD`bi{kNszyS&>sw&U;G^!>*7ZtI>%I(teTL&c7v?T&D<i7?e~<^)|Lh)t&s`4*w6D2$1Kp*-Krt||9T;5m z+~>VbV|#w$>nuqC61A1aCu-4=T)PrYAB6&Q>4FvhH%qB<$cMlk@>aU}gnY-m%2kx4LX*M0y5BdXUu zcCSqY($V4`yL*gyI=|ru-JNBD)vOh8GCTszgx?Ic2or-)M7z;s|2t&vZnRFlG&vc0 zVe+#4%FC1T)P%KltvH7GwDnpUr|4J^Q5sq}7!1dKNt*7EBX>yaeGlP|enkdByPy(p b-`~7_TcmHx+qdVs#BrT#bN2~;O&R|Ul2E)Z literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_generator.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_generator.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..061e423a16a692ab5233dffb87476c1e65af096c GIT binary patch literal 3088 zcma)8TW=Fb6rNe{I_vn73$~jJ2^Q%ELkZBTEmV{?4VNI%fPjkBa_cVMjj?goVP*|= zlt=+Ziqobgs6bMwQl+XdC@+2JzvxTSl;W&XsZz^B-a-;8#8c1N^*V7tZI85PW@paK zne)xL%+G#*EdhFb`u9{xB;-&0aY!n6*3Ls`ny5sjSu#Lkgc4OyU0FIH!~{wNa)PMh z7*QpS%)0C~F_-EdBQa5}0WMh*GDvtdp(5cf)JDC_C?2JzoMM`$XEkG)mIuyj+~`)g zmb5ptIZh(2y$WoaXe35e5))Jk`UFd#3-#e?Vs2FeUZd5-fl?80GlSmbeJTdXVb6%e--Hhxkr1Wf+;F2#ZB?@HI+wQrpUEyKSKA!SIf&?89rd>~lj0?K@|m<{o&XrJtijSu-MP zXsjAhYXHIIHNfBub=!*GXBD9ZmZD40nI=ZXpPmQUEXW{%-&NoQ2vNZnawJENS+DKk9{pXC_;7Kq=G157`487@Q8qa5q zD)a#ZUHh!stL%YopoH%MHcFPl?GM7y`EYb0ya(LNTWSbRx87>~x~=G5^wyQOH5Whl zE6_S8w^}$wJ?N{tGN2_AW^E!dkW=$n?E4alD|sbr&#)%gngx(GA`2ng4$Kr$KMUeN z-mm2)46(8pUaaLFW2EG77(Ko!2vYN^EJ!b|%2W!jy4}+Dm3ra}UO#Ft$CXt+f}U$# z-EYwOzgIUx4JU6xTo`x?i)PCg%6AXbQLllXZ;?u8%Pw()4%3X4jh#8W{m&igB<%UT zl^KkiEi_CVeHejJp?4@;NNZU&lFJ)Bt!fb^Vux6?#&RF_0&HN`rg>WDhN34m3tZE8 zHm@7$0qq!LIc8r`GYCR{l&&h-yk^o=mHS8^p%V5o$h5=9&jJH~k?SAGt@Cp0g4{OR zwG?QYY54Z|uYrz|*H=8W)Yv|^^LZc7wukxJ9f*Mbb}IIwq@v0i!lKbqN9rf+_0iO*%8!I#Ih8 zhMzlhqx4)LKf-1)7nB&`>Gq90d^np+Dp`J{^MsS+d!r(2gVhY}XFHH#ii6@O_UHAa zm2XDvOy{XAVo?y;1s_Mpcrr#71C7NC6N2rr7<7=X&~YJj(L#np7Vw{zbC;)bCWb}x z6`aQqdNNA>7N``ueSDoj^M^M$CkAc&V75XP!!hO))9nZX)TwULG`>DGz5M2| zeTTgSnuc~&-$^Gv6*fH*D$bdD9i({&FmQ*ZP|M7LyM0r%R3Du7-tx|L-3~0(ho+P} z@*|0a+b!o++bac({ z=(;bzZ=v#>*nS68Zmmt7IEHK=d>rfb7+Dj%Qa82Z8K-*7dDkQi?Y8R~rcE0;Ym4fV zXUd1|%6Wvn3vw7!92Km%D5Vcc+d~pw7eh2y>{}<$tnPQy*40KA4XxMvXg8hedrYvk Gj_?nJ`(V=m literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_generator_nested.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_generator_nested.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0e081d022ea3f0c2fc6d97201c2c2e4a3bdd87ca GIT binary patch literal 7782 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 d4!6Y{;|;O*O& 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 F{stHMLaG1& literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet_trash.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_greenlet_trash.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7625d3774492f627defbf68f7f1c6243b40cdcf1 GIT binary patch literal 6795 zcmbVQU2GfImA*p`#UVwRk|`S}tzU_->Yb)*)0kR1Cpoao->>@!HD0Z3QEmX7a_FKLtt!U zWsF;U;#4@2_vXD(zx->Skl=`Fn1-0tshFawnoX}rRS&2r9~zQW&xmr+ zfOXO;EJ9UTiHT=&Ce&dvt}!7`Ppermhhr)l_J~?iH1v!L6+m2JZ|QmQGs zn~+nomW_$$U`IXTj4CQR6BxX%(!8kNm`-a6%}nQe#Btb{mKAl7MnN(P?n-M@DoDEy z!lI&PiU~cJR?tc^9oJw#||Dt;DFgp zfFA-SN#&FVAV7amHLZbhz;lXf%32z#N#+9wf;4q1&wNqF!s;G-Lo% zO6IbVwe+kNmd6b}oikMlu%c7b5)|#aWH=A1t-TA}iQsAQCblBxuug5I->oS=S09eNNAABpLvDEABQspoKSVt+=wr^>1)!2lfHN4A1&gGp za7w6B7EA(ZcMZoyJ!`o8HQeazYyV(|doak?0d0tr*cu*~QNe0-6HH8UYZSYz+Vjkf zaY}V+d5yebg&@D8KP4@j)Gfi7(x%ZzmXFHWlxhi(=o3?tW`gs0Lro`{9NK`wILSa` zBJ{t$)qi~KZ9um%CTj}SjIm4k#Dq*Um#B^hi7_@!57@D3>U1ovr;M?2C?zK49~kET7<%hvBWY||pucD<^p!&OA6%Tj_~YT{Ueeg{)yoD_-|+?EVcZ`=+dqqJ zUybZ3M)oY7S-QL&+5hRa(3J{7LM8+D_>JW}Kgo#N#x_FceXeYdeB-<-R7~M2^KN~^iVC-Jx0Ue<#1qI$~%d#geLH|hxUnzu}Xzc6ommDWH-SD4pUWduLj{|bolq&_aP1Hj z+DkYI5*ufg?*?a~_2<5g#}OVzqdfe4igy&kV$=^m0e*o30r*2mj0Ov&z!f|NZ-Iv( zsezVSWcgnosFqmV>==6kS#sJq85?jI^LwCG5L2W3^tmU#eHD+aM&h1lEWtm$$O$+ncM0|UVQm1>jn4j}Zb3Y40fS|XR0k&3A{3kT0R>=)=PT$|W^4+uP7$GTEL`;8u8 ztjK1g)x^#?6mbF_;@+(`ISvSMRX)4f#Hi&O+GHr|u{h20_g{(kjl>6{UW$p$3U9H3 z<#&*8pd&=_Hbp9E2@((s&6K3sBmY$V#N2t;K#GCM?JGF6L!>>r!2hhKRNwL-{FCs~ zYsLD#zX-p8Ub5+MMOwnJP!Ar*3;<~p2W@%gee9-x1$wI>!#F$dpLBD{hMDeh2uDpB zGcdAz>{N!%ms#o!;IA;g%suD0YAn)~jBIq{5q^uy9+>Oas_$Z@ny@qz|5 zu66+=6t(WZ${UV0XIDTuc!-&5#~<&+OqmRPi}klNX-$=t+?wJ_D<3;~#?(RPHg`x$K29NkEWu@ir|Nc6xDNC zrA&M2t2mm^zy}ipU4XHA8y`F7{LZ;Dd-$IXId&XrAkp{}6cBNxNXvsGA0AoW(fc&g z`)~ZOL;oHs?TfAMJ67Cx?Ag8(3xhu!F2#vLFAjb*Tx#9% zDD*J&t8EK?rH;-e&o7TI3@sjgzKyi)EH$@1c;~}+7U@sMmL|%=e)D>9-(cyLC0`rS*Hi}m~dyMA{m(yWBwa%rrG zBH2g`Y%uzn0P8a zwa4v%wlmmy3W~4pkmnv>T|JnlrL!=&UPHEb6wZFOy`9xtTG^|uy>K3~X6KH=g_pd) z?v*baJL_W42^91dkio=m;!cn{`i6zeAJ!~zUj#^`X+21qnhWP_Ct?(-Q2q^9F;k6}113(41<+xfdsTQVGkS(9>z4 zB#=1~DfZU|9+5!L;eWIm?Z=`DxS6F4R2wtbY5QThi{e#kw)5}V5JSkg3|{@qZSn`9 z?t4(XNNPmb*`_2&XqRuC{d- z+qxh3tq8Gofz&lX5vX%!G!#2eJnMXOMK}qob?hqm?}tAti`&$RQ`(C{`{L2nj^1KN z?$8pd3Hje-Db;9*=MRNLc5`J0pj)!Yr>{@Mqwb=gZOM?H_VR=4On0@MPEAb7t T&)vQF{fj>whVz4OXPfvd1D}s- literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_leaks.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_leaks.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c3eec9c0011cee7bff5b857ef2840e59df52403d GIT binary patch literal 19471 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 s=mYc=_k<#exf49a^6Aun+a literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_stack_saved.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_stack_saved.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..99100aac195f14efd997a739dd29a2147850453c GIT binary patch literal 1367 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 dt>m&Fxf0XK literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_version.cpython-312.pyc b/.venv/Lib/site-packages/greenlet/tests/__pycache__/test_version.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cee99a804d25c96d36c956edcb80bc91d042d9c6 GIT binary patch literal 2574 zcmbUjTTB#J^xk>w0~QwLSwvmBSi2#tR?@6i3Moozj8a-2k#)^v*tsmT?9QxrW_fIP z(Ka@L#MGrt3Z@S+G0}#P{`AB2tMS(+T>?fr#iWVphkrycHuk6Y&N92y(3tdYIOoiH z-E+=8_gwCmm6ZUpo_+8ra-0X?G5xR>`8LgFEU69+tDZ(X55}OQk0tTd^#4K)UW*FT@mFbE)@_0M^8cN(HhCu#X zF2m`imMrSBs3J~tme;pIhEMZRcTr|hi(5o=m&GY!OO~;bLX+Pjlb1n|2GPo*o<&`< z=~WgTt+A*gF4|85FVG8uCV&rSSmJZ*xC#P7NUUx(2S~G4J}DxxXb1*LY#DZnz4~1q zkHc{=!486P=ml>94UUu683d60u3pIVeYWm@9StoxO=!bIQk>fsT68OAA}g$DA)o?_ z6vPS#GilHZBIIa`3GV2Hw!=&76&B8y)XArA-YLqr_O~!;q%uoif)@8AxbO)e#gdo^ zOtUGHNrp>PnxiF6g9xNJ!|R2{-7)rZ%X1N@`OiVd_KFO4$T@AZV$0alaHlpbYQX<< zG6nw{ym~2Z3zKH(1su=|4J?t?qghL44fJX&r*xre+uQ9^=;OPe(6Xl(zdu!VLQTdb zkD}_HVOfy~h#^m^L;o zYAOf@k3}Vd3@)n5ieVEI38Y9y`Fom%Fr7_Z7^~P|H68ox24~vxI+l@Sa3csK1Ih-I zOkg?=41So(HClB~e!Un!@lL3pxY9zREMZv-^-P9GL>%wIY7~WaEtJ455u_k2>M9P! z)QA=uB2XZ42=V0TvBM$%7*fVUXXK%fChMprA%;iA2+~3kjF1vT`XQZ8J`)OK`B~^s zOd3_RJc6XgWku9wC1R$V3T&U2erj2;X^W|0F{ZWqcQT}tO#799%V5pD>)QCt__e8- zsd;I|?Om|WR$V`T z-;6q@#2--(HsBxF?>} zbk7j-s7c+U4tsP`eZR+mr1v~6En9W>xo{QnXE?M`IYA#JOq-iD&!lFQpa~RC>eM@? zuZY1XRMKh&hmj~5JkgaCMyY7FUDw5=7&9E!2^*z?bxMLjyHG>1VZ1lL6OCLT=M9nJ zl9e%a6bWX~1{@}FYz4NxC2<2abZtNT)NB9Q7IgAx-w<#aJY~wAA-L{go&E5)+U7f_ zmumylr#4GK%i$lo7rTEtm8N-WDS%{)RaeEevomLN^{0R7 z&3*XM{eh+W-iNNfC0F0y>nv4x@w|k%%9VLvXs?q1KXY^faCd)aD|-((I}fw>oO?T) z*?Y}ArCa&VHhZ^^qxYWPQF8A~1R<_UNpl9c1c8=3FTsb1x9r4>8sM>9 L<$-5_VAIP#?mE!r_Sv8jO|1qSjoTJkJ*{o z*_q$^&uBD4pglTuH!V~`{=q@eLiJ8<3_4|E6Pr3@%Ky?SD#yx{Vk@@lsI%IXMu|c` zA+~mr*deB^gFb9ip(Pp*-^1?YJqj47p8h2h?g>k<6ix>X7qQg_0Lp|BGy(?bMKYz@ z3ZQ1IfT1NV9`cN@nKg5UO`|H23ijfD4Ss06_A>xD4*M@qw;_>LV7jd-Cw3*Pe0~ZvuABPrXZw%oD~?J(A1G>P|3jTb z`&LetPOf!VV{cWBc#+=GBP)?ogq z9>e~t00Iva1ifDdJ(IIiZf1c6iCWmRHSp~+c!%OW07w#}7o+~Gz7dO8V)1J1VAU9T z+1URJDle&*v@%JP%UV$_YST!jdJ7qXOnU<=tW)4+wWL0qU!KENK-wiWpuXo3D$r%a zu1zi|+tX@Evq_o;IwhT|t#pc9E&1&a==`FTNoO;qZj*pP%4D}mzicDfo`xxqr=&!; zXZ}*-bqJ1xjt;+&{37{Y{e~=3KP^Kt8NEoFxv6>1SeMSo}=J^ccg?F|lBrvN3d>Z8JQxf&J$W%WLS|2Zy`-&PJl2kTaF^8+> zz72DvVvcN>M=Iu#zs#e5n|3?IaBO@)ZFvM? zsr6No=a#RM56Io}D7+hbg(EL;j^HsEgpKvb;JRC+<}GYKqWe`cK*ia)#%}(QYVa6<;PPX7wsu34SHVfyRNM++|u{U zgHFc7o}NtRtXY;!dXZ#uHgC^6*f)|%d{X=s{u;Q$-$2-pfHx-h`;o`e;s{8*0yFI* zd7yNJ_CDCDhW6GXM(BVqjWR%`k~<}zB9(fCV}(ftZJOcf_Z=GJ2SEgRK)eZXU!|1Z cCY`rQcP&h)d6(>ZsJ%`PT>an?fsZuyKa<}t*8l(j literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/_test_extension.c b/.venv/Lib/site-packages/greenlet/tests/_test_extension.c new file mode 100644 index 0000000..05e81c0 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/_test_extension.c @@ -0,0 +1,231 @@ +/* This is a set of functions used by test_extension_interface.py to test the + * Greenlet C API. + */ + +#include "../greenlet.h" + +#ifndef Py_RETURN_NONE +# define Py_RETURN_NONE return Py_INCREF(Py_None), Py_None +#endif + +#define TEST_MODULE_NAME "_test_extension" + +static PyObject* +test_switch(PyObject* self, PyObject* greenlet) +{ + PyObject* result = NULL; + + if (greenlet == NULL || !PyGreenlet_Check(greenlet)) { + PyErr_BadArgument(); + return NULL; + } + + result = PyGreenlet_Switch((PyGreenlet*)greenlet, NULL, NULL); + if (result == NULL) { + if (!PyErr_Occurred()) { + PyErr_SetString(PyExc_AssertionError, + "greenlet.switch() failed for some reason."); + } + return NULL; + } + Py_INCREF(result); + return result; +} + +static PyObject* +test_switch_kwargs(PyObject* self, PyObject* args, PyObject* kwargs) +{ + PyGreenlet* g = NULL; + PyObject* result = NULL; + + PyArg_ParseTuple(args, "O!", &PyGreenlet_Type, &g); + + if (g == NULL || !PyGreenlet_Check(g)) { + PyErr_BadArgument(); + return NULL; + } + + result = PyGreenlet_Switch(g, NULL, kwargs); + if (result == NULL) { + if (!PyErr_Occurred()) { + PyErr_SetString(PyExc_AssertionError, + "greenlet.switch() failed for some reason."); + } + return NULL; + } + Py_XINCREF(result); + return result; +} + +static PyObject* +test_getcurrent(PyObject* self) +{ + PyGreenlet* g = PyGreenlet_GetCurrent(); + if (g == NULL || !PyGreenlet_Check(g) || !PyGreenlet_ACTIVE(g)) { + PyErr_SetString(PyExc_AssertionError, + "getcurrent() returned an invalid greenlet"); + Py_XDECREF(g); + return NULL; + } + Py_DECREF(g); + Py_RETURN_NONE; +} + +static PyObject* +test_setparent(PyObject* self, PyObject* arg) +{ + PyGreenlet* current; + PyGreenlet* greenlet = NULL; + + if (arg == NULL || !PyGreenlet_Check(arg)) { + PyErr_BadArgument(); + return NULL; + } + if ((current = PyGreenlet_GetCurrent()) == NULL) { + return NULL; + } + greenlet = (PyGreenlet*)arg; + if (PyGreenlet_SetParent(greenlet, current)) { + Py_DECREF(current); + return NULL; + } + Py_DECREF(current); + if (PyGreenlet_Switch(greenlet, NULL, NULL) == NULL) { + return NULL; + } + Py_RETURN_NONE; +} + +static PyObject* +test_new_greenlet(PyObject* self, PyObject* callable) +{ + PyObject* result = NULL; + PyGreenlet* greenlet = PyGreenlet_New(callable, NULL); + + if (!greenlet) { + return NULL; + } + + result = PyGreenlet_Switch(greenlet, NULL, NULL); + Py_CLEAR(greenlet); + if (result == NULL) { + return NULL; + } + + Py_INCREF(result); + return result; +} + +static PyObject* +test_raise_dead_greenlet(PyObject* self) +{ + PyErr_SetString(PyExc_GreenletExit, "test GreenletExit exception."); + return NULL; +} + +static PyObject* +test_raise_greenlet_error(PyObject* self) +{ + PyErr_SetString(PyExc_GreenletError, "test greenlet.error exception"); + return NULL; +} + +static PyObject* +test_throw(PyObject* self, PyGreenlet* g) +{ + const char msg[] = "take that sucka!"; + PyObject* msg_obj = Py_BuildValue("s", msg); + PyGreenlet_Throw(g, PyExc_ValueError, msg_obj, NULL); + Py_DECREF(msg_obj); + if (PyErr_Occurred()) { + return NULL; + } + Py_RETURN_NONE; +} + +static PyObject* +test_throw_exact(PyObject* self, PyObject* args) +{ + PyGreenlet* g = NULL; + PyObject* typ = NULL; + PyObject* val = NULL; + PyObject* tb = NULL; + + if (!PyArg_ParseTuple(args, "OOOO:throw", &g, &typ, &val, &tb)) { + return NULL; + } + + PyGreenlet_Throw(g, typ, val, tb); + if (PyErr_Occurred()) { + return NULL; + } + Py_RETURN_NONE; +} + +static PyMethodDef test_methods[] = { + {"test_switch", + (PyCFunction)test_switch, + METH_O, + "Switch to the provided greenlet sending provided arguments, and \n" + "return the results."}, + {"test_switch_kwargs", + (PyCFunction)test_switch_kwargs, + METH_VARARGS | METH_KEYWORDS, + "Switch to the provided greenlet sending the provided keyword args."}, + {"test_getcurrent", + (PyCFunction)test_getcurrent, + METH_NOARGS, + "Test PyGreenlet_GetCurrent()"}, + {"test_setparent", + (PyCFunction)test_setparent, + METH_O, + "Se the parent of the provided greenlet and switch to it."}, + {"test_new_greenlet", + (PyCFunction)test_new_greenlet, + METH_O, + "Test PyGreenlet_New()"}, + {"test_raise_dead_greenlet", + (PyCFunction)test_raise_dead_greenlet, + METH_NOARGS, + "Just raise greenlet.GreenletExit"}, + {"test_raise_greenlet_error", + (PyCFunction)test_raise_greenlet_error, + METH_NOARGS, + "Just raise greenlet.error"}, + {"test_throw", + (PyCFunction)test_throw, + METH_O, + "Throw a ValueError at the provided greenlet"}, + {"test_throw_exact", + (PyCFunction)test_throw_exact, + METH_VARARGS, + "Throw exactly the arguments given at the provided greenlet"}, + {NULL, NULL, 0, NULL} +}; + + +#define INITERROR return NULL + +static struct PyModuleDef moduledef = {PyModuleDef_HEAD_INIT, + TEST_MODULE_NAME, + NULL, + 0, + test_methods, + NULL, + NULL, + NULL, + NULL}; + +PyMODINIT_FUNC +PyInit__test_extension(void) +{ + PyObject* module = NULL; + module = PyModule_Create(&moduledef); + + if (module == NULL) { + return NULL; + } + + PyGreenlet_Import(); + return module; +} diff --git a/.venv/Lib/site-packages/greenlet/tests/_test_extension.cp312-win_amd64.pyd b/.venv/Lib/site-packages/greenlet/tests/_test_extension.cp312-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..a93796d44303309b23bb597ababe4b6819dcf1fe GIT binary patch literal 14336 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 V(E^$KI#M0%;lFE7|F1OuKLBsv>CgZG literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/greenlet/tests/_test_extension_cpp.cp312-win_amd64.pyd b/.venv/Lib/site-packages/greenlet/tests/_test_extension_cpp.cp312-win_amd64.pyd new file mode 100644 index 0000000000000000000000000000000000000000..f80b6df11ba4238d9cc90e06d3697973af264632 GIT binary patch literal 15872 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 +#include + +struct exception_t { + int depth; + exception_t(int depth) : depth(depth) {} +}; + +/* Functions are called via pointers to prevent inlining */ +static void (*p_test_exception_throw_nonstd)(int depth); +static void (*p_test_exception_throw_std)(); +static PyObject* (*p_test_exception_switch_recurse)(int depth, int left); + +static void +test_exception_throw_nonstd(int depth) +{ + throw exception_t(depth); +} + +static void +test_exception_throw_std() +{ + throw std::runtime_error("Thrown from an extension."); +} + +static PyObject* +test_exception_switch_recurse(int depth, int left) +{ + if (left > 0) { + return p_test_exception_switch_recurse(depth, left - 1); + } + + PyObject* result = NULL; + PyGreenlet* self = PyGreenlet_GetCurrent(); + if (self == NULL) + return NULL; + + try { + if (PyGreenlet_Switch(PyGreenlet_GET_PARENT(self), NULL, NULL) == NULL) { + Py_DECREF(self); + return NULL; + } + p_test_exception_throw_nonstd(depth); + PyErr_SetString(PyExc_RuntimeError, + "throwing C++ exception didn't work"); + } + catch (const exception_t& e) { + if (e.depth != depth) + PyErr_SetString(PyExc_AssertionError, "depth mismatch"); + else + result = PyLong_FromLong(depth); + } + catch (...) { + PyErr_SetString(PyExc_RuntimeError, "unexpected C++ exception"); + } + + Py_DECREF(self); + return result; +} + +/* test_exception_switch(int depth) + * - recurses depth times + * - switches to parent inside try/catch block + * - throws an exception that (expected to be caught in the same function) + * - verifies depth matches (exceptions shouldn't be caught in other greenlets) + */ +static PyObject* +test_exception_switch(PyObject* UNUSED(self), PyObject* args) +{ + int depth; + if (!PyArg_ParseTuple(args, "i", &depth)) + return NULL; + return p_test_exception_switch_recurse(depth, depth); +} + + +static PyObject* +py_test_exception_throw_nonstd(PyObject* self, PyObject* args) +{ + if (!PyArg_ParseTuple(args, "")) + return NULL; + p_test_exception_throw_nonstd(0); + PyErr_SetString(PyExc_AssertionError, "unreachable code running after throw"); + return NULL; +} + +static PyObject* +py_test_exception_throw_std(PyObject* self, PyObject* args) +{ + if (!PyArg_ParseTuple(args, "")) + return NULL; + p_test_exception_throw_std(); + PyErr_SetString(PyExc_AssertionError, "unreachable code running after throw"); + return NULL; +} + +static PyObject* +py_test_call(PyObject* self, PyObject* arg) +{ + PyObject* noargs = PyTuple_New(0); + PyObject* ret = PyObject_Call(arg, noargs, nullptr); + Py_DECREF(noargs); + return ret; +} + + + +/* test_exception_switch_and_do_in_g2(g2func) + * - creates new greenlet g2 to run g2func + * - switches to g2 inside try/catch block + * - verifies that no exception has been caught + * + * it is used together with test_exception_throw to verify that unhandled + * exceptions thrown in one greenlet do not propagate to other greenlet nor + * segfault the process. + */ +static PyObject* +test_exception_switch_and_do_in_g2(PyObject* self, PyObject* args) +{ + PyObject* g2func = NULL; + PyObject* result = NULL; + + if (!PyArg_ParseTuple(args, "O", &g2func)) + return NULL; + PyGreenlet* g2 = PyGreenlet_New(g2func, NULL); + if (!g2) { + return NULL; + } + + try { + result = PyGreenlet_Switch(g2, NULL, NULL); + if (!result) { + return NULL; + } + } + catch (const exception_t& e) { + /* if we are here the memory can be already corrupted and the program + * might crash before below py-level exception might become printed. + * -> print something to stderr to make it clear that we had entered + * this catch block. + * See comments in inner_bootstrap() + */ +#if defined(WIN32) || defined(_WIN32) + fprintf(stderr, "C++ exception unexpectedly caught in g1\n"); + PyErr_SetString(PyExc_AssertionError, "C++ exception unexpectedly caught in g1"); + Py_XDECREF(result); + return NULL; +#else + throw; +#endif + } + + Py_XDECREF(result); + Py_RETURN_NONE; +} + +static PyMethodDef test_methods[] = { + {"test_exception_switch", + (PyCFunction)&test_exception_switch, + METH_VARARGS, + "Switches to parent twice, to test exception handling and greenlet " + "switching."}, + {"test_exception_switch_and_do_in_g2", + (PyCFunction)&test_exception_switch_and_do_in_g2, + METH_VARARGS, + "Creates new greenlet g2 to run g2func and switches to it inside try/catch " + "block. Used together with test_exception_throw to verify that unhandled " + "C++ exceptions thrown in a greenlet doe not corrupt memory."}, + {"test_exception_throw_nonstd", + (PyCFunction)&py_test_exception_throw_nonstd, + METH_VARARGS, + "Throws non-standard C++ exception. Calling this function directly should abort the process." + }, + {"test_exception_throw_std", + (PyCFunction)&py_test_exception_throw_std, + METH_VARARGS, + "Throws standard C++ exception. Calling this function directly should abort the process." + }, + {"test_call", + (PyCFunction)&py_test_call, + METH_O, + "Call the given callable. Unlike calling it directly, this creates a " + "new C-level stack frame, which may be helpful in testing." + }, + {NULL, NULL, 0, NULL} +}; + + +static struct PyModuleDef moduledef = {PyModuleDef_HEAD_INIT, + "greenlet.tests._test_extension_cpp", + NULL, + 0, + test_methods, + NULL, + NULL, + NULL, + NULL}; + +PyMODINIT_FUNC +PyInit__test_extension_cpp(void) +{ + PyObject* module = NULL; + + module = PyModule_Create(&moduledef); + + if (module == NULL) { + return NULL; + } + + PyGreenlet_Import(); + if (_PyGreenlet_API == NULL) { + return NULL; + } + + p_test_exception_throw_nonstd = test_exception_throw_nonstd; + p_test_exception_throw_std = test_exception_throw_std; + p_test_exception_switch_recurse = test_exception_switch_recurse; + + return module; +} diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py b/.venv/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py new file mode 100644 index 0000000..6dd1492 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_clearing_run_switches.py @@ -0,0 +1,47 @@ +# -*- coding: utf-8 -*- +""" +If we have a run callable passed to the constructor or set as an +attribute, but we don't actually use that (because ``__getattribute__`` +or the like interferes), then when we clear callable before beginning +to run, there's an opportunity for Python code to run. + +""" +import greenlet + +g = None +main = greenlet.getcurrent() + +results = [] + +class RunCallable: + + def __del__(self): + results.append(('RunCallable', '__del__')) + main.switch('from RunCallable') + + +class G(greenlet.greenlet): + + def __getattribute__(self, name): + if name == 'run': + results.append(('G.__getattribute__', 'run')) + return run_func + return object.__getattribute__(self, name) + + +def run_func(): + results.append(('run_func', 'enter')) + + +g = G(RunCallable()) +# Try to start G. It will get to the point where it deletes +# its run callable C++ variable in inner_bootstrap. That triggers +# the __del__ method, which switches back to main before g +# actually even starts running. +x = g.switch() +results.append(('main: g.switch()', x)) +# In the C++ code, this results in g->g_switch() appearing to return, even though +# it has yet to run. +print('In main with', x, flush=True) +g.switch() +print('RESULTS', results) diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_cpp_exception.py b/.venv/Lib/site-packages/greenlet/tests/fail_cpp_exception.py new file mode 100644 index 0000000..fa4dc2e --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_cpp_exception.py @@ -0,0 +1,33 @@ +# -*- coding: utf-8 -*- +""" +Helper for testing a C++ exception throw aborts the process. + +Takes one argument, the name of the function in :mod:`_test_extension_cpp` to call. +""" +import sys +import greenlet +from greenlet.tests import _test_extension_cpp +print('fail_cpp_exception is running') + +def run_unhandled_exception_in_greenlet_aborts(): + def _(): + _test_extension_cpp.test_exception_switch_and_do_in_g2( + _test_extension_cpp.test_exception_throw_nonstd + ) + g1 = greenlet.greenlet(_) + g1.switch() + + +func_name = sys.argv[1] +try: + func = getattr(_test_extension_cpp, func_name) +except AttributeError: + if func_name == run_unhandled_exception_in_greenlet_aborts.__name__: + func = run_unhandled_exception_in_greenlet_aborts + elif func_name == 'run_as_greenlet_target': + g = greenlet.greenlet(_test_extension_cpp.test_exception_throw_std) + func = g.switch + else: + raise +print('raising', func, flush=True) +func() diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py b/.venv/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py new file mode 100644 index 0000000..c1a44ef --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_initialstub_already_started.py @@ -0,0 +1,78 @@ +""" +Testing initialstub throwing an already started exception. +""" + +import greenlet + +a = None +b = None +c = None +main = greenlet.getcurrent() + +# If we switch into a dead greenlet, +# we go looking for its parents. +# if a parent is not yet started, we start it. + +results = [] + +def a_run(*args): + #results.append('A') + results.append(('Begin A', args)) + + +def c_run(): + results.append('Begin C') + b.switch('From C') + results.append('C done') + +class A(greenlet.greenlet): pass + +class B(greenlet.greenlet): + doing_it = False + def __getattribute__(self, name): + if name == 'run' and not self.doing_it: + assert greenlet.getcurrent() is c + self.doing_it = True + results.append('Switch to b from B.__getattribute__ in ' + + type(greenlet.getcurrent()).__name__) + b.switch() + results.append('B.__getattribute__ back from main in ' + + type(greenlet.getcurrent()).__name__) + if name == 'run': + name = '_B_run' + return object.__getattribute__(self, name) + + def _B_run(self, *arg): + results.append(('Begin B', arg)) + results.append('_B_run switching to main') + main.switch('From B') + +class C(greenlet.greenlet): + pass +a = A(a_run) +b = B(parent=a) +c = C(c_run, b) + +# Start a child; while running, it will start B, +# but starting B will ALSO start B. +result = c.switch() +results.append(('main from c', result)) + +# Switch back to C, which was in the middle of switching +# already. This will throw the ``GreenletStartedWhileInPython`` +# exception, which results in parent A getting started (B is finished) +c.switch() + +results.append(('A dead?', a.dead, 'B dead?', b.dead, 'C dead?', c.dead)) + +# A and B should both be dead now. +assert a.dead +assert b.dead +assert not c.dead + +result = c.switch() +results.append(('main from c.2', result)) +# Now C is dead +assert c.dead + +print("RESULTS:", results) diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_slp_switch.py b/.venv/Lib/site-packages/greenlet/tests/fail_slp_switch.py new file mode 100644 index 0000000..0990526 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_slp_switch.py @@ -0,0 +1,29 @@ +# -*- coding: utf-8 -*- +""" +A test helper for seeing what happens when slp_switch() +fails. +""" +# pragma: no cover + +import greenlet + + +print('fail_slp_switch is running', flush=True) + +runs = [] +def func(): + runs.append(1) + greenlet.getcurrent().parent.switch() + runs.append(2) + greenlet.getcurrent().parent.switch() + runs.append(3) + +g = greenlet._greenlet.UnswitchableGreenlet(func) +g.switch() +assert runs == [1] +g.switch() +assert runs == [1, 2] +g.force_slp_switch_error = True + +# This should crash. +g.switch() diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py b/.venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py new file mode 100644 index 0000000..e151b19 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets.py @@ -0,0 +1,44 @@ +""" +Uses a trace function to switch greenlets at unexpected times. + +In the trace function, we switch from the current greenlet to another +greenlet, which switches +""" +import greenlet + +g1 = None +g2 = None + +switch_to_g2 = False + +def tracefunc(*args): + print('TRACE', *args) + global switch_to_g2 + if switch_to_g2: + switch_to_g2 = False + g2.switch() + print('\tLEAVE TRACE', *args) + +def g1_run(): + print('In g1_run') + global switch_to_g2 + switch_to_g2 = True + from_parent = greenlet.getcurrent().parent.switch() + print('Return to g1_run') + print('From parent', from_parent) + +def g2_run(): + #g1.switch() + greenlet.getcurrent().parent.switch() + +greenlet.settrace(tracefunc) + +g1 = greenlet.greenlet(g1_run) +g2 = greenlet.greenlet(g2_run) + +# This switch didn't actually finish! +# And if it did, it would raise TypeError +# because g1_run() doesn't take any arguments. +g1.switch(1) +print('Back in main') +g1.switch(2) diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py b/.venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py new file mode 100644 index 0000000..1f6b66b --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_switch_three_greenlets2.py @@ -0,0 +1,55 @@ +""" +Like fail_switch_three_greenlets, but the call into g1_run would actually be +valid. +""" +import greenlet + +g1 = None +g2 = None + +switch_to_g2 = True + +results = [] + +def tracefunc(*args): + results.append(('trace', args[0])) + print('TRACE', *args) + global switch_to_g2 + if switch_to_g2: + switch_to_g2 = False + g2.switch('g2 from tracefunc') + print('\tLEAVE TRACE', *args) + +def g1_run(arg): + results.append(('g1 arg', arg)) + print('In g1_run') + from_parent = greenlet.getcurrent().parent.switch('from g1_run') + results.append(('g1 from parent', from_parent)) + return 'g1 done' + +def g2_run(arg): + #g1.switch() + results.append(('g2 arg', arg)) + parent = greenlet.getcurrent().parent.switch('from g2_run') + global switch_to_g2 + switch_to_g2 = False + results.append(('g2 from parent', parent)) + return 'g2 done' + + +greenlet.settrace(tracefunc) + +g1 = greenlet.greenlet(g1_run) +g2 = greenlet.greenlet(g2_run) + +x = g1.switch('g1 from main') +results.append(('main g1', x)) +print('Back in main', x) +x = g1.switch('g2 from main') +results.append(('main g2', x)) +print('back in amain again', x) +x = g1.switch('g1 from main 2') +results.append(('main g1.2', x)) +x = g2.switch() +results.append(('main g2.2', x)) +print("RESULTS:", results) diff --git a/.venv/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py b/.venv/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py new file mode 100644 index 0000000..3e52345 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/fail_switch_two_greenlets.py @@ -0,0 +1,41 @@ +""" +Uses a trace function to switch greenlets at unexpected times. + +In the trace function, we switch from the current greenlet to another +greenlet, which switches +""" +import greenlet + +g1 = None +g2 = None + +switch_to_g2 = False + +def tracefunc(*args): + print('TRACE', *args) + global switch_to_g2 + if switch_to_g2: + switch_to_g2 = False + g2.switch() + print('\tLEAVE TRACE', *args) + +def g1_run(): + print('In g1_run') + global switch_to_g2 + switch_to_g2 = True + greenlet.getcurrent().parent.switch() + print('Return to g1_run') + print('Falling off end of g1_run') + +def g2_run(): + g1.switch() + print('Falling off end of g2') + +greenlet.settrace(tracefunc) + +g1 = greenlet.greenlet(g1_run) +g2 = greenlet.greenlet(g2_run) + +g1.switch() +print('Falling off end of main') +g2.switch() diff --git a/.venv/Lib/site-packages/greenlet/tests/leakcheck.py b/.venv/Lib/site-packages/greenlet/tests/leakcheck.py new file mode 100644 index 0000000..a5152fb --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/leakcheck.py @@ -0,0 +1,319 @@ +# Copyright (c) 2018 gevent community +# Copyright (c) 2021 greenlet community +# +# This was originally part of gevent's test suite. The main author +# (Jason Madden) vendored a copy of it into greenlet. +# +# 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 print_function + +import os +import sys +import gc + +from functools import wraps +import unittest + + +import objgraph + +# graphviz 0.18 (Nov 7 2021), available only on Python 3.6 and newer, +# has added type hints (sigh). It wants to use ``typing.Literal`` for +# some stuff, but that's only available on Python 3.9+. If that's not +# found, it creates a ``unittest.mock.MagicMock`` object and annotates +# with that. These are GC'able objects, and doing almost *anything* +# with them results in an explosion of objects. For example, trying to +# compare them for equality creates new objects. This causes our +# leakchecks to fail, with reports like: +# +# greenlet.tests.leakcheck.LeakCheckError: refcount increased by [337, 1333, 343, 430, 530, 643, 769] +# _Call 1820 +546 +# dict 4094 +76 +# MagicProxy 585 +73 +# tuple 2693 +66 +# _CallList 24 +3 +# weakref 1441 +1 +# function 5996 +1 +# type 736 +1 +# cell 592 +1 +# MagicMock 8 +1 +# +# To avoid this, we *could* filter this type of object out early. In +# principle it could leak, but we don't use mocks in greenlet, so it +# doesn't leak from us. However, a further issue is that ``MagicMock`` +# objects have subobjects that are also GC'able, like ``_Call``, and +# those create new mocks of their own too. So we'd have to filter them +# as well, and they're not public. That's OK, we can workaround the +# problem by being very careful to never compare by equality or other +# user-defined operators, only using object identity or other builtin +# functions. + +RUNNING_ON_GITHUB_ACTIONS = os.environ.get('GITHUB_ACTIONS') +RUNNING_ON_TRAVIS = os.environ.get('TRAVIS') or RUNNING_ON_GITHUB_ACTIONS +RUNNING_ON_APPVEYOR = os.environ.get('APPVEYOR') +RUNNING_ON_CI = RUNNING_ON_TRAVIS or RUNNING_ON_APPVEYOR +RUNNING_ON_MANYLINUX = os.environ.get('GREENLET_MANYLINUX') +SKIP_LEAKCHECKS = RUNNING_ON_MANYLINUX or os.environ.get('GREENLET_SKIP_LEAKCHECKS') +SKIP_FAILING_LEAKCHECKS = os.environ.get('GREENLET_SKIP_FAILING_LEAKCHECKS') +ONLY_FAILING_LEAKCHECKS = os.environ.get('GREENLET_ONLY_FAILING_LEAKCHECKS') + +def ignores_leakcheck(func): + """ + Ignore the given object during leakchecks. + + Can be applied to a method, in which case the method will run, but + will not be subject to leak checks. + + If applied to a class, the entire class will be skipped during leakchecks. This + is intended to be used for classes that are very slow and cause problems such as + test timeouts; typically it will be used for classes that are subclasses of a base + class and specify variants of behaviour (such as pool sizes). + """ + func.ignore_leakcheck = True + return func + +def fails_leakcheck(func): + """ + Mark that the function is known to leak. + """ + func.fails_leakcheck = True + if SKIP_FAILING_LEAKCHECKS: + func = unittest.skip("Skipping known failures")(func) + return func + +class LeakCheckError(AssertionError): + pass + +if hasattr(sys, 'getobjects'): + # In a Python build with ``--with-trace-refs``, make objgraph + # trace *all* the objects, not just those that are tracked by the + # GC + class _MockGC(object): + def get_objects(self): + return sys.getobjects(0) # pylint:disable=no-member + def __getattr__(self, name): + return getattr(gc, name) + objgraph.gc = _MockGC() + fails_strict_leakcheck = fails_leakcheck +else: + def fails_strict_leakcheck(func): + """ + Decorator for a function that is known to fail when running + strict (``sys.getobjects()``) leakchecks. + + This type of leakcheck finds all objects, even those, such as + strings, which are not tracked by the garbage collector. + """ + return func + +class ignores_types_in_strict_leakcheck(object): + def __init__(self, types): + self.types = types + def __call__(self, func): + func.leakcheck_ignore_types = self.types + return func + +class _RefCountChecker(object): + + # Some builtin things that we ignore + # XXX: Those things were ignored by gevent, but they're important here, + # presumably. + IGNORED_TYPES = () #(tuple, dict, types.FrameType, types.TracebackType) + + def __init__(self, testcase, function): + self.testcase = testcase + self.function = function + self.deltas = [] + self.peak_stats = {} + self.ignored_types = () + + # The very first time we are called, we have already been + # self.setUp() by the test runner, so we don't need to do it again. + self.needs_setUp = False + + def _include_object_p(self, obj): + # pylint:disable=too-many-return-statements + # + # See the comment block at the top. We must be careful to + # avoid invoking user-defined operations. + if obj is self: + return False + kind = type(obj) + # ``self._include_object_p == obj`` returns NotImplemented + # for non-function objects, which causes the interpreter + # to try to reverse the order of arguments...which leads + # to the explosion of mock objects. We don't want that, so we implement + # the check manually. + if kind == type(self._include_object_p): + try: + # pylint:disable=not-callable + exact_method_equals = self._include_object_p.__eq__(obj) + except AttributeError: + # Python 2.7 methods may only have __cmp__, and that raises a + # TypeError for non-method arguments + # pylint:disable=no-member + exact_method_equals = self._include_object_p.__cmp__(obj) == 0 + + if exact_method_equals is not NotImplemented and exact_method_equals: + return False + + # Similarly, we need to check identity in our __dict__ to avoid mock explosions. + for x in self.__dict__.values(): + if obj is x: + return False + + + if kind in self.ignored_types or kind in self.IGNORED_TYPES: + return False + + return True + + def _growth(self): + return objgraph.growth(limit=None, peak_stats=self.peak_stats, + filter=self._include_object_p) + + def _report_diff(self, growth): + if not growth: + return "" + + lines = [] + width = max(len(name) for name, _, _ in growth) + for name, count, delta in growth: + lines.append('%-*s%9d %+9d' % (width, name, count, delta)) + + diff = '\n'.join(lines) + return diff + + + def _run_test(self, args, kwargs): + gc_enabled = gc.isenabled() + gc.disable() + + if self.needs_setUp: + self.testcase.setUp() + self.testcase.skipTearDown = False + try: + self.function(self.testcase, *args, **kwargs) + finally: + self.testcase.tearDown() + self.testcase.doCleanups() + self.testcase.skipTearDown = True + self.needs_setUp = True + if gc_enabled: + gc.enable() + + def _growth_after(self): + # Grab post snapshot + # pylint:disable=no-member + if 'urlparse' in sys.modules: + sys.modules['urlparse'].clear_cache() + if 'urllib.parse' in sys.modules: + sys.modules['urllib.parse'].clear_cache() + + return self._growth() + + def _check_deltas(self, growth): + # Return false when we have decided there is no leak, + # true if we should keep looping, raises an assertion + # if we have decided there is a leak. + + deltas = self.deltas + if not deltas: + # We haven't run yet, no data, keep looping + return True + + if gc.garbage: + raise LeakCheckError("Generated uncollectable garbage %r" % (gc.garbage,)) + + + # the following configurations are classified as "no leak" + # [0, 0] + # [x, 0, 0] + # [... a, b, c, d] where a+b+c+d = 0 + # + # the following configurations are classified as "leak" + # [... z, z, z] where z > 0 + + if deltas[-2:] == [0, 0] and len(deltas) in (2, 3): + return False + + if deltas[-3:] == [0, 0, 0]: + return False + + if len(deltas) >= 4 and sum(deltas[-4:]) == 0: + return False + + if len(deltas) >= 3 and deltas[-1] > 0 and deltas[-1] == deltas[-2] and deltas[-2] == deltas[-3]: + diff = self._report_diff(growth) + raise LeakCheckError('refcount increased by %r\n%s' % (deltas, diff)) + + # OK, we don't know for sure yet. Let's search for more + if sum(deltas[-3:]) <= 0 or sum(deltas[-4:]) <= 0 or deltas[-4:].count(0) >= 2: + # this is suspicious, so give a few more runs + limit = 11 + else: + limit = 7 + if len(deltas) >= limit: + raise LeakCheckError('refcount increased by %r\n%s' + % (deltas, + self._report_diff(growth))) + + # We couldn't decide yet, keep going + return True + + def __call__(self, args, kwargs): + for _ in range(3): + gc.collect() + + expect_failure = getattr(self.function, 'fails_leakcheck', False) + if expect_failure: + self.testcase.expect_greenlet_leak = True + self.ignored_types = getattr(self.function, "leakcheck_ignore_types", ()) + + # Capture state before; the incremental will be + # updated by each call to _growth_after + growth = self._growth() + + try: + while self._check_deltas(growth): + self._run_test(args, kwargs) + + growth = self._growth_after() + + self.deltas.append(sum((stat[2] for stat in growth))) + except LeakCheckError: + if not expect_failure: + raise + else: + if expect_failure: + raise LeakCheckError("Expected %s to leak but it did not." % (self.function,)) + +def wrap_refcount(method): + if getattr(method, 'ignore_leakcheck', False) or SKIP_LEAKCHECKS: + return method + + @wraps(method) + def wrapper(self, *args, **kwargs): # pylint:disable=too-many-branches + if getattr(self, 'ignore_leakcheck', False): + raise unittest.SkipTest("This class ignored during leakchecks") + if ONLY_FAILING_LEAKCHECKS and not getattr(method, 'fails_leakcheck', False): + raise unittest.SkipTest("Only running tests that fail leakchecks.") + return _RefCountChecker(self, method)(args, kwargs) + + return wrapper diff --git a/.venv/Lib/site-packages/greenlet/tests/test_contextvars.py b/.venv/Lib/site-packages/greenlet/tests/test_contextvars.py new file mode 100644 index 0000000..9a16f67 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_contextvars.py @@ -0,0 +1,310 @@ +from __future__ import print_function + +import gc +import sys +import unittest + +from functools import partial +from unittest import skipUnless +from unittest import skipIf + +from greenlet import greenlet +from greenlet import getcurrent +from . import TestCase + + +try: + from contextvars import Context + from contextvars import ContextVar + from contextvars import copy_context + # From the documentation: + # + # Important: Context Variables should be created at the top module + # level and never in closures. Context objects hold strong + # references to context variables which prevents context variables + # from being properly garbage collected. + ID_VAR = ContextVar("id", default=None) + VAR_VAR = ContextVar("var", default=None) + ContextVar = None +except ImportError: + Context = ContextVar = copy_context = None + +# We don't support testing if greenlet's built-in context var support is disabled. +@skipUnless(Context is not None, "ContextVar not supported") +class ContextVarsTests(TestCase): + def _new_ctx_run(self, *args, **kwargs): + return copy_context().run(*args, **kwargs) + + def _increment(self, greenlet_id, callback, counts, expect): + ctx_var = ID_VAR + if expect is None: + self.assertIsNone(ctx_var.get()) + else: + self.assertEqual(ctx_var.get(), expect) + ctx_var.set(greenlet_id) + for _ in range(2): + counts[ctx_var.get()] += 1 + callback() + + def _test_context(self, propagate_by): + # pylint:disable=too-many-branches + ID_VAR.set(0) + + callback = getcurrent().switch + counts = dict((i, 0) for i in range(5)) + + lets = [ + greenlet(partial( + partial( + copy_context().run, + self._increment + ) if propagate_by == "run" else self._increment, + greenlet_id=i, + callback=callback, + counts=counts, + expect=( + i - 1 if propagate_by == "share" else + 0 if propagate_by in ("set", "run") else None + ) + )) + for i in range(1, 5) + ] + + for let in lets: + if propagate_by == "set": + let.gr_context = copy_context() + elif propagate_by == "share": + let.gr_context = getcurrent().gr_context + + for i in range(2): + counts[ID_VAR.get()] += 1 + for let in lets: + let.switch() + + if propagate_by == "run": + # Must leave each context.run() in reverse order of entry + for let in reversed(lets): + let.switch() + else: + # No context.run(), so fine to exit in any order. + for let in lets: + let.switch() + + for let in lets: + self.assertTrue(let.dead) + # When using run(), we leave the run() as the greenlet dies, + # and there's no context "underneath". When not using run(), + # gr_context still reflects the context the greenlet was + # running in. + if propagate_by == 'run': + self.assertIsNone(let.gr_context) + else: + self.assertIsNotNone(let.gr_context) + + + if propagate_by == "share": + self.assertEqual(counts, {0: 1, 1: 1, 2: 1, 3: 1, 4: 6}) + else: + self.assertEqual(set(counts.values()), set([2])) + + def test_context_propagated_by_context_run(self): + self._new_ctx_run(self._test_context, "run") + + def test_context_propagated_by_setting_attribute(self): + self._new_ctx_run(self._test_context, "set") + + def test_context_not_propagated(self): + self._new_ctx_run(self._test_context, None) + + def test_context_shared(self): + self._new_ctx_run(self._test_context, "share") + + def test_break_ctxvars(self): + let1 = greenlet(copy_context().run) + let2 = greenlet(copy_context().run) + let1.switch(getcurrent().switch) + let2.switch(getcurrent().switch) + # Since let2 entered the current context and let1 exits its own, the + # interpreter emits: + # RuntimeError: cannot exit context: thread state references a different context object + let1.switch() + + def test_not_broken_if_using_attribute_instead_of_context_run(self): + let1 = greenlet(getcurrent().switch) + let2 = greenlet(getcurrent().switch) + let1.gr_context = copy_context() + let2.gr_context = copy_context() + let1.switch() + let2.switch() + let1.switch() + let2.switch() + + def test_context_assignment_while_running(self): + # pylint:disable=too-many-statements + ID_VAR.set(None) + + def target(): + self.assertIsNone(ID_VAR.get()) + self.assertIsNone(gr.gr_context) + + # Context is created on first use + ID_VAR.set(1) + self.assertIsInstance(gr.gr_context, Context) + self.assertEqual(ID_VAR.get(), 1) + self.assertEqual(gr.gr_context[ID_VAR], 1) + + # Clearing the context makes it get re-created as another + # empty context when next used + old_context = gr.gr_context + gr.gr_context = None # assign None while running + self.assertIsNone(ID_VAR.get()) + self.assertIsNone(gr.gr_context) + ID_VAR.set(2) + self.assertIsInstance(gr.gr_context, Context) + self.assertEqual(ID_VAR.get(), 2) + self.assertEqual(gr.gr_context[ID_VAR], 2) + + new_context = gr.gr_context + getcurrent().parent.switch((old_context, new_context)) + # parent switches us back to old_context + + self.assertEqual(ID_VAR.get(), 1) + gr.gr_context = new_context # assign non-None while running + self.assertEqual(ID_VAR.get(), 2) + + getcurrent().parent.switch() + # parent switches us back to no context + self.assertIsNone(ID_VAR.get()) + self.assertIsNone(gr.gr_context) + gr.gr_context = old_context + self.assertEqual(ID_VAR.get(), 1) + + getcurrent().parent.switch() + # parent switches us back to no context + self.assertIsNone(ID_VAR.get()) + self.assertIsNone(gr.gr_context) + + gr = greenlet(target) + + with self.assertRaisesRegex(AttributeError, "can't delete context attribute"): + del gr.gr_context + + self.assertIsNone(gr.gr_context) + old_context, new_context = gr.switch() + self.assertIs(new_context, gr.gr_context) + self.assertEqual(old_context[ID_VAR], 1) + self.assertEqual(new_context[ID_VAR], 2) + self.assertEqual(new_context.run(ID_VAR.get), 2) + gr.gr_context = old_context # assign non-None while suspended + gr.switch() + self.assertIs(gr.gr_context, new_context) + gr.gr_context = None # assign None while suspended + gr.switch() + self.assertIs(gr.gr_context, old_context) + gr.gr_context = None + gr.switch() + self.assertIsNone(gr.gr_context) + + # Make sure there are no reference leaks + gr = None + gc.collect() + self.assertEqual(sys.getrefcount(old_context), 2) + self.assertEqual(sys.getrefcount(new_context), 2) + + def test_context_assignment_different_thread(self): + import threading + VAR_VAR.set(None) + ctx = Context() + + is_running = threading.Event() + should_suspend = threading.Event() + did_suspend = threading.Event() + should_exit = threading.Event() + holder = [] + + def greenlet_in_thread_fn(): + VAR_VAR.set(1) + is_running.set() + should_suspend.wait(10) + VAR_VAR.set(2) + getcurrent().parent.switch() + holder.append(VAR_VAR.get()) + + def thread_fn(): + gr = greenlet(greenlet_in_thread_fn) + gr.gr_context = ctx + holder.append(gr) + gr.switch() + did_suspend.set() + should_exit.wait(10) + gr.switch() + del gr + greenlet() # trigger cleanup + + thread = threading.Thread(target=thread_fn, daemon=True) + thread.start() + is_running.wait(10) + gr = holder[0] + + # Can't access or modify context if the greenlet is running + # in a different thread + with self.assertRaisesRegex(ValueError, "running in a different"): + getattr(gr, 'gr_context') + with self.assertRaisesRegex(ValueError, "running in a different"): + gr.gr_context = None + + should_suspend.set() + did_suspend.wait(10) + + # OK to access and modify context if greenlet is suspended + self.assertIs(gr.gr_context, ctx) + self.assertEqual(gr.gr_context[VAR_VAR], 2) + gr.gr_context = None + + should_exit.set() + thread.join(10) + + self.assertEqual(holder, [gr, None]) + + # Context can still be accessed/modified when greenlet is dead: + self.assertIsNone(gr.gr_context) + gr.gr_context = ctx + self.assertIs(gr.gr_context, ctx) + + # Otherwise we leak greenlets on some platforms. + # XXX: Should be able to do this automatically + del holder[:] + gr = None + thread = None + + def test_context_assignment_wrong_type(self): + g = greenlet() + with self.assertRaisesRegex(TypeError, + "greenlet context must be a contextvars.Context or None"): + g.gr_context = self + + +@skipIf(Context is not None, "ContextVar supported") +class NoContextVarsTests(TestCase): + def test_contextvars_errors(self): + let1 = greenlet(getcurrent().switch) + self.assertFalse(hasattr(let1, 'gr_context')) + with self.assertRaises(AttributeError): + getattr(let1, 'gr_context') + + with self.assertRaises(AttributeError): + let1.gr_context = None + + let1.switch() + + with self.assertRaises(AttributeError): + getattr(let1, 'gr_context') + + with self.assertRaises(AttributeError): + let1.gr_context = None + + del let1 + + +if __name__ == '__main__': + unittest.main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_cpp.py b/.venv/Lib/site-packages/greenlet/tests/test_cpp.py new file mode 100644 index 0000000..2d0cc9c --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_cpp.py @@ -0,0 +1,73 @@ +from __future__ import print_function +from __future__ import absolute_import + +import subprocess +import unittest + +import greenlet +from . import _test_extension_cpp +from . import TestCase +from . import WIN + +class CPPTests(TestCase): + def test_exception_switch(self): + greenlets = [] + for i in range(4): + g = greenlet.greenlet(_test_extension_cpp.test_exception_switch) + g.switch(i) + greenlets.append(g) + for i, g in enumerate(greenlets): + self.assertEqual(g.switch(), i) + + def _do_test_unhandled_exception(self, target): + import os + import sys + script = os.path.join( + os.path.dirname(__file__), + 'fail_cpp_exception.py', + ) + args = [sys.executable, script, target.__name__ if not isinstance(target, str) else target] + __traceback_info__ = args + with self.assertRaises(subprocess.CalledProcessError) as exc: + subprocess.check_output( + args, + encoding='utf-8', + stderr=subprocess.STDOUT + ) + + ex = exc.exception + expected_exit = self.get_expected_returncodes_for_aborted_process() + self.assertIn(ex.returncode, expected_exit) + self.assertIn('fail_cpp_exception is running', ex.output) + return ex.output + + + def test_unhandled_nonstd_exception_aborts(self): + # verify that plain unhandled throw aborts + self._do_test_unhandled_exception(_test_extension_cpp.test_exception_throw_nonstd) + + def test_unhandled_std_exception_aborts(self): + # verify that plain unhandled throw aborts + self._do_test_unhandled_exception(_test_extension_cpp.test_exception_throw_std) + + @unittest.skipIf(WIN, "XXX: This does not crash on Windows") + # Meaning the exception is getting lost somewhere... + def test_unhandled_std_exception_as_greenlet_function_aborts(self): + # verify that plain unhandled throw aborts + output = self._do_test_unhandled_exception('run_as_greenlet_target') + self.assertIn( + # We really expect this to be prefixed with "greenlet: Unhandled C++ exception:" + # as added by our handler for std::exception (see TUserGreenlet.cpp), but + # that's not correct everywhere --- our handler never runs before std::terminate + # gets called (for example, on arm32). + 'Thrown from an extension.', + output + ) + + def test_unhandled_exception_in_greenlet_aborts(self): + # verify that unhandled throw called in greenlet aborts too + self._do_test_unhandled_exception('run_unhandled_exception_in_greenlet_aborts') + + +if __name__ == '__main__': + unittest.main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_extension_interface.py b/.venv/Lib/site-packages/greenlet/tests/test_extension_interface.py new file mode 100644 index 0000000..34b6656 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_extension_interface.py @@ -0,0 +1,115 @@ +from __future__ import print_function +from __future__ import absolute_import + +import sys + +import greenlet +from . import _test_extension +from . import TestCase + +# pylint:disable=c-extension-no-member + +class CAPITests(TestCase): + def test_switch(self): + self.assertEqual( + 50, _test_extension.test_switch(greenlet.greenlet(lambda: 50))) + + def test_switch_kwargs(self): + def adder(x, y): + return x * y + g = greenlet.greenlet(adder) + self.assertEqual(6, _test_extension.test_switch_kwargs(g, x=3, y=2)) + + def test_setparent(self): + # pylint:disable=disallowed-name + def foo(): + def bar(): + greenlet.getcurrent().parent.switch() + + # This final switch should go back to the main greenlet, since + # the test_setparent() function in the C extension should have + # reparented this greenlet. + greenlet.getcurrent().parent.switch() + raise AssertionError("Should never have reached this code") + child = greenlet.greenlet(bar) + child.switch() + greenlet.getcurrent().parent.switch(child) + greenlet.getcurrent().parent.throw( + AssertionError("Should never reach this code")) + foo_child = greenlet.greenlet(foo).switch() + self.assertEqual(None, _test_extension.test_setparent(foo_child)) + + def test_getcurrent(self): + _test_extension.test_getcurrent() + + def test_new_greenlet(self): + self.assertEqual(-15, _test_extension.test_new_greenlet(lambda: -15)) + + def test_raise_greenlet_dead(self): + self.assertRaises( + greenlet.GreenletExit, _test_extension.test_raise_dead_greenlet) + + def test_raise_greenlet_error(self): + self.assertRaises( + greenlet.error, _test_extension.test_raise_greenlet_error) + + def test_throw(self): + seen = [] + + def foo(): # pylint:disable=disallowed-name + try: + greenlet.getcurrent().parent.switch() + except ValueError: + seen.append(sys.exc_info()[1]) + except greenlet.GreenletExit: + raise AssertionError + g = greenlet.greenlet(foo) + g.switch() + _test_extension.test_throw(g) + self.assertEqual(len(seen), 1) + self.assertTrue( + isinstance(seen[0], ValueError), + "ValueError was not raised in foo()") + self.assertEqual( + str(seen[0]), + 'take that sucka!', + "message doesn't match") + + def test_non_traceback_param(self): + with self.assertRaises(TypeError) as exc: + _test_extension.test_throw_exact( + greenlet.getcurrent(), + Exception, + Exception(), + self + ) + self.assertEqual(str(exc.exception), + "throw() third argument must be a traceback object") + + def test_instance_of_wrong_type(self): + with self.assertRaises(TypeError) as exc: + _test_extension.test_throw_exact( + greenlet.getcurrent(), + Exception(), + BaseException(), + None, + ) + + self.assertEqual(str(exc.exception), + "instance exception may not have a separate value") + + def test_not_throwable(self): + with self.assertRaises(TypeError) as exc: + _test_extension.test_throw_exact( + greenlet.getcurrent(), + "abc", + None, + None, + ) + self.assertEqual(str(exc.exception), + "exceptions must be classes, or instances, not str") + + +if __name__ == '__main__': + import unittest + unittest.main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_gc.py b/.venv/Lib/site-packages/greenlet/tests/test_gc.py new file mode 100644 index 0000000..994addb --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_gc.py @@ -0,0 +1,86 @@ +import gc + +import weakref + +import greenlet + + +from . import TestCase +from .leakcheck import fails_leakcheck +# These only work with greenlet gc support +# which is no longer optional. +assert greenlet.GREENLET_USE_GC + +class GCTests(TestCase): + def test_dead_circular_ref(self): + o = weakref.ref(greenlet.greenlet(greenlet.getcurrent).switch()) + gc.collect() + if o() is not None: + import sys + print("O IS NOT NONE.", sys.getrefcount(o())) + self.assertIsNone(o()) + self.assertFalse(gc.garbage, gc.garbage) + + def test_circular_greenlet(self): + class circular_greenlet(greenlet.greenlet): + self = None + o = circular_greenlet() + o.self = o + o = weakref.ref(o) + gc.collect() + self.assertIsNone(o()) + self.assertFalse(gc.garbage, gc.garbage) + + def test_inactive_ref(self): + class inactive_greenlet(greenlet.greenlet): + def __init__(self): + greenlet.greenlet.__init__(self, run=self.run) + + def run(self): + pass + o = inactive_greenlet() + o = weakref.ref(o) + gc.collect() + self.assertIsNone(o()) + self.assertFalse(gc.garbage, gc.garbage) + + @fails_leakcheck + def test_finalizer_crash(self): + # This test is designed to crash when active greenlets + # are made garbage collectable, until the underlying + # problem is resolved. How does it work: + # - order of object creation is important + # - array is created first, so it is moved to unreachable first + # - we create a cycle between a greenlet and this array + # - we create an object that participates in gc, is only + # referenced by a greenlet, and would corrupt gc lists + # on destruction, the easiest is to use an object with + # a finalizer + # - because array is the first object in unreachable it is + # cleared first, which causes all references to greenlet + # to disappear and causes greenlet to be destroyed, but since + # it is still live it causes a switch during gc, which causes + # an object with finalizer to be destroyed, which causes stack + # corruption and then a crash + + class object_with_finalizer(object): + def __del__(self): + pass + array = [] + parent = greenlet.getcurrent() + def greenlet_body(): + greenlet.getcurrent().object = object_with_finalizer() + try: + parent.switch() + except greenlet.GreenletExit: + print("Got greenlet exit!") + finally: + del greenlet.getcurrent().object + g = greenlet.greenlet(greenlet_body) + g.array = array + array.append(g) + g.switch() + del array + del g + greenlet.getcurrent() + gc.collect() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_generator.py b/.venv/Lib/site-packages/greenlet/tests/test_generator.py new file mode 100644 index 0000000..ca4a644 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_generator.py @@ -0,0 +1,59 @@ + +from greenlet import greenlet + +from . import TestCase + +class genlet(greenlet): + parent = None + def __init__(self, *args, **kwds): + self.args = args + self.kwds = kwds + + def run(self): + fn, = self.fn + fn(*self.args, **self.kwds) + + def __iter__(self): + return self + + def __next__(self): + self.parent = greenlet.getcurrent() + result = self.switch() + if self: + return result + + raise StopIteration + + next = __next__ + + +def Yield(value): + g = greenlet.getcurrent() + while not isinstance(g, genlet): + if g is None: + raise RuntimeError('yield outside a genlet') + g = g.parent + g.parent.switch(value) + + +def generator(func): + class Generator(genlet): + fn = (func,) + return Generator + +# ____________________________________________________________ + + +class GeneratorTests(TestCase): + def test_generator(self): + seen = [] + + def g(n): + for i in range(n): + seen.append(i) + Yield(i) + g = generator(g) + for _ in range(3): + for j in g(5): + seen.append(j) + self.assertEqual(seen, 3 * [0, 0, 1, 1, 2, 2, 3, 3, 4, 4]) diff --git a/.venv/Lib/site-packages/greenlet/tests/test_generator_nested.py b/.venv/Lib/site-packages/greenlet/tests/test_generator_nested.py new file mode 100644 index 0000000..8d752a6 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_generator_nested.py @@ -0,0 +1,168 @@ + +from greenlet import greenlet +from . import TestCase +from .leakcheck import fails_leakcheck + +class genlet(greenlet): + parent = None + def __init__(self, *args, **kwds): + self.args = args + self.kwds = kwds + self.child = None + + def run(self): + # Note the function is packed in a tuple + # to avoid creating a bound method for it. + fn, = self.fn + fn(*self.args, **self.kwds) + + def __iter__(self): + return self + + def set_child(self, child): + self.child = child + + def __next__(self): + if self.child: + child = self.child + while child.child: + tmp = child + child = child.child + tmp.child = None + + result = child.switch() + else: + self.parent = greenlet.getcurrent() + result = self.switch() + + if self: + return result + + raise StopIteration + + next = __next__ + +def Yield(value, level=1): + g = greenlet.getcurrent() + + while level != 0: + if not isinstance(g, genlet): + raise RuntimeError('yield outside a genlet') + if level > 1: + g.parent.set_child(g) + g = g.parent + level -= 1 + + g.switch(value) + + +def Genlet(func): + class TheGenlet(genlet): + fn = (func,) + return TheGenlet + +# ____________________________________________________________ + + +def g1(n, seen): + for i in range(n): + seen.append(i + 1) + yield i + + +def g2(n, seen): + for i in range(n): + seen.append(i + 1) + Yield(i) + +g2 = Genlet(g2) + + +def nested(i): + Yield(i) + + +def g3(n, seen): + for i in range(n): + seen.append(i + 1) + nested(i) +g3 = Genlet(g3) + + +def a(n): + if n == 0: + return + for ii in ax(n - 1): + Yield(ii) + Yield(n) +ax = Genlet(a) + + +def perms(l): + if len(l) > 1: + for e in l: + # No syntactical sugar for generator expressions + x = [Yield([e] + p) for p in perms([x for x in l if x != e])] + assert x + else: + Yield(l) +perms = Genlet(perms) + + +def gr1(n): + for ii in range(1, n): + Yield(ii) + Yield(ii * ii, 2) + +gr1 = Genlet(gr1) + + +def gr2(n, seen): + for ii in gr1(n): + seen.append(ii) + +gr2 = Genlet(gr2) + + +class NestedGeneratorTests(TestCase): + def test_layered_genlets(self): + seen = [] + for ii in gr2(5, seen): + seen.append(ii) + self.assertEqual(seen, [1, 1, 2, 4, 3, 9, 4, 16]) + + @fails_leakcheck + def test_permutations(self): + gen_perms = perms(list(range(4))) + permutations = list(gen_perms) + self.assertEqual(len(permutations), 4 * 3 * 2 * 1) + self.assertIn([0, 1, 2, 3], permutations) + self.assertIn([3, 2, 1, 0], permutations) + res = [] + for ii in zip(perms(list(range(4))), perms(list(range(3)))): + res.append(ii) + self.assertEqual( + res, + [([0, 1, 2, 3], [0, 1, 2]), ([0, 1, 3, 2], [0, 2, 1]), + ([0, 2, 1, 3], [1, 0, 2]), ([0, 2, 3, 1], [1, 2, 0]), + ([0, 3, 1, 2], [2, 0, 1]), ([0, 3, 2, 1], [2, 1, 0])]) + # XXX Test to make sure we are working as a generator expression + + def test_genlet_simple(self): + for g in g1, g2, g3: + seen = [] + for _ in range(3): + for j in g(5, seen): + seen.append(j) + self.assertEqual(seen, 3 * [1, 0, 2, 1, 3, 2, 4, 3, 5, 4]) + + def test_genlet_bad(self): + try: + Yield(10) + except RuntimeError: + pass + + def test_nested_genlets(self): + seen = [] + for ii in ax(5): + seen.append(ii) diff --git a/.venv/Lib/site-packages/greenlet/tests/test_greenlet.py b/.venv/Lib/site-packages/greenlet/tests/test_greenlet.py new file mode 100644 index 0000000..c4aabea --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_greenlet.py @@ -0,0 +1,1324 @@ +import gc +import sys +import time +import threading +import unittest + +from abc import ABCMeta +from abc import abstractmethod + +import greenlet +from greenlet import greenlet as RawGreenlet +from . import TestCase +from . import RUNNING_ON_MANYLINUX +from . import PY313 +from .leakcheck import fails_leakcheck + + +# We manually manage locks in many tests +# pylint:disable=consider-using-with +# pylint:disable=too-many-public-methods +# This module is quite large. +# TODO: Refactor into separate test files. For example, +# put all the regression tests that used to produce +# crashes in test_greenlet_no_crash; put tests that DO deliberately crash +# the interpreter into test_greenlet_crash. +# pylint:disable=too-many-lines + +class SomeError(Exception): + pass + + +def fmain(seen): + try: + greenlet.getcurrent().parent.switch() + except: + seen.append(sys.exc_info()[0]) + raise + raise SomeError + + +def send_exception(g, exc): + # note: send_exception(g, exc) can be now done with g.throw(exc). + # the purpose of this test is to explicitly check the propagation rules. + def crasher(exc): + raise exc + g1 = RawGreenlet(crasher, parent=g) + g1.switch(exc) + + +class TestGreenlet(TestCase): + + def _do_simple_test(self): + lst = [] + + def f(): + lst.append(1) + greenlet.getcurrent().parent.switch() + lst.append(3) + g = RawGreenlet(f) + lst.append(0) + g.switch() + lst.append(2) + g.switch() + lst.append(4) + self.assertEqual(lst, list(range(5))) + + def test_simple(self): + self._do_simple_test() + + def test_switch_no_run_raises_AttributeError(self): + g = RawGreenlet() + with self.assertRaises(AttributeError) as exc: + g.switch() + + self.assertIn("run", str(exc.exception)) + + def test_throw_no_run_raises_AttributeError(self): + g = RawGreenlet() + with self.assertRaises(AttributeError) as exc: + g.throw(SomeError) + + self.assertIn("run", str(exc.exception)) + + def test_parent_equals_None(self): + g = RawGreenlet(parent=None) + self.assertIsNotNone(g) + self.assertIs(g.parent, greenlet.getcurrent()) + + def test_run_equals_None(self): + g = RawGreenlet(run=None) + self.assertIsNotNone(g) + self.assertIsNone(g.run) + + def test_two_children(self): + lst = [] + + def f(): + lst.append(1) + greenlet.getcurrent().parent.switch() + lst.extend([1, 1]) + g = RawGreenlet(f) + h = RawGreenlet(f) + g.switch() + self.assertEqual(len(lst), 1) + h.switch() + self.assertEqual(len(lst), 2) + h.switch() + self.assertEqual(len(lst), 4) + self.assertEqual(h.dead, True) + g.switch() + self.assertEqual(len(lst), 6) + self.assertEqual(g.dead, True) + + def test_two_recursive_children(self): + lst = [] + + def f(): + lst.append('b') + greenlet.getcurrent().parent.switch() + + def g(): + lst.append('a') + g = RawGreenlet(f) + g.switch() + lst.append('c') + + g = RawGreenlet(g) + self.assertEqual(sys.getrefcount(g), 2) + g.switch() + self.assertEqual(lst, ['a', 'b', 'c']) + # Just the one in this frame, plus the one on the stack we pass to the function + self.assertEqual(sys.getrefcount(g), 2) + + def test_threads(self): + success = [] + + def f(): + self._do_simple_test() + success.append(True) + ths = [threading.Thread(target=f) for i in range(10)] + for th in ths: + th.start() + for th in ths: + th.join(10) + self.assertEqual(len(success), len(ths)) + + def test_exception(self): + seen = [] + g1 = RawGreenlet(fmain) + g2 = RawGreenlet(fmain) + g1.switch(seen) + g2.switch(seen) + g2.parent = g1 + + self.assertEqual(seen, []) + #with self.assertRaises(SomeError): + # p("***Switching back") + # g2.switch() + # Creating this as a bound method can reveal bugs that + # are hidden on newer versions of Python that avoid creating + # bound methods for direct expressions; IOW, don't use the `with` + # form! + self.assertRaises(SomeError, g2.switch) + self.assertEqual(seen, [SomeError]) + + value = g2.switch() + self.assertEqual(value, ()) + self.assertEqual(seen, [SomeError]) + + value = g2.switch(25) + self.assertEqual(value, 25) + self.assertEqual(seen, [SomeError]) + + + def test_send_exception(self): + seen = [] + g1 = RawGreenlet(fmain) + g1.switch(seen) + self.assertRaises(KeyError, send_exception, g1, KeyError) + self.assertEqual(seen, [KeyError]) + + def test_dealloc(self): + seen = [] + g1 = RawGreenlet(fmain) + g2 = RawGreenlet(fmain) + g1.switch(seen) + g2.switch(seen) + self.assertEqual(seen, []) + del g1 + gc.collect() + self.assertEqual(seen, [greenlet.GreenletExit]) + del g2 + gc.collect() + self.assertEqual(seen, [greenlet.GreenletExit, greenlet.GreenletExit]) + + def test_dealloc_catches_GreenletExit_throws_other(self): + def run(): + try: + greenlet.getcurrent().parent.switch() + except greenlet.GreenletExit: + raise SomeError from None + + g = RawGreenlet(run) + g.switch() + # Destroying the only reference to the greenlet causes it + # to get GreenletExit; when it in turn raises, even though we're the parent + # we don't get the exception, it just gets printed. + # When we run on 3.8 only, we can use sys.unraisablehook + oldstderr = sys.stderr + from io import StringIO + stderr = sys.stderr = StringIO() + try: + del g + finally: + sys.stderr = oldstderr + + v = stderr.getvalue() + self.assertIn("Exception", v) + self.assertIn('ignored', v) + self.assertIn("SomeError", v) + + + @unittest.skipIf( + PY313 and RUNNING_ON_MANYLINUX, + "Sometimes flaky (getting one GreenletExit in the second list)" + # Probably due to funky timing interactions? + # TODO: FIXME Make that work. + ) + + def test_dealloc_other_thread(self): + seen = [] + someref = [] + + bg_glet_created_running_and_no_longer_ref_in_bg = threading.Event() + fg_ref_released = threading.Event() + bg_should_be_clear = threading.Event() + ok_to_exit_bg_thread = threading.Event() + + def f(): + g1 = RawGreenlet(fmain) + g1.switch(seen) + someref.append(g1) + del g1 + gc.collect() + + bg_glet_created_running_and_no_longer_ref_in_bg.set() + fg_ref_released.wait(3) + + RawGreenlet() # trigger release + bg_should_be_clear.set() + ok_to_exit_bg_thread.wait(3) + RawGreenlet() # One more time + + t = threading.Thread(target=f) + t.start() + bg_glet_created_running_and_no_longer_ref_in_bg.wait(10) + + self.assertEqual(seen, []) + self.assertEqual(len(someref), 1) + del someref[:] + gc.collect() + # g1 is not released immediately because it's from another thread + self.assertEqual(seen, []) + fg_ref_released.set() + bg_should_be_clear.wait(3) + try: + self.assertEqual(seen, [greenlet.GreenletExit]) + finally: + ok_to_exit_bg_thread.set() + t.join(10) + del seen[:] + del someref[:] + + def test_frame(self): + def f1(): + f = sys._getframe(0) # pylint:disable=protected-access + self.assertEqual(f.f_back, None) + greenlet.getcurrent().parent.switch(f) + return "meaning of life" + g = RawGreenlet(f1) + frame = g.switch() + self.assertTrue(frame is g.gr_frame) + self.assertTrue(g) + + from_g = g.switch() + self.assertFalse(g) + self.assertEqual(from_g, 'meaning of life') + self.assertEqual(g.gr_frame, None) + + def test_thread_bug(self): + def runner(x): + g = RawGreenlet(lambda: time.sleep(x)) + g.switch() + t1 = threading.Thread(target=runner, args=(0.2,)) + t2 = threading.Thread(target=runner, args=(0.3,)) + t1.start() + t2.start() + t1.join(10) + t2.join(10) + + def test_switch_kwargs(self): + def run(a, b): + self.assertEqual(a, 4) + self.assertEqual(b, 2) + return 42 + x = RawGreenlet(run).switch(a=4, b=2) + self.assertEqual(x, 42) + + def test_switch_kwargs_to_parent(self): + def run(x): + greenlet.getcurrent().parent.switch(x=x) + greenlet.getcurrent().parent.switch(2, x=3) + return x, x ** 2 + g = RawGreenlet(run) + self.assertEqual({'x': 3}, g.switch(3)) + self.assertEqual(((2,), {'x': 3}), g.switch()) + self.assertEqual((3, 9), g.switch()) + + def test_switch_to_another_thread(self): + data = {} + created_event = threading.Event() + done_event = threading.Event() + + def run(): + data['g'] = RawGreenlet(lambda: None) + created_event.set() + done_event.wait(10) + thread = threading.Thread(target=run) + thread.start() + created_event.wait(10) + with self.assertRaises(greenlet.error): + data['g'].switch() + done_event.set() + thread.join(10) + # XXX: Should handle this automatically + data.clear() + + def test_exc_state(self): + def f(): + try: + raise ValueError('fun') + except: # pylint:disable=bare-except + exc_info = sys.exc_info() + RawGreenlet(h).switch() + self.assertEqual(exc_info, sys.exc_info()) + + def h(): + self.assertEqual(sys.exc_info(), (None, None, None)) + + RawGreenlet(f).switch() + + def test_instance_dict(self): + def f(): + greenlet.getcurrent().test = 42 + def deldict(g): + del g.__dict__ + def setdict(g, value): + g.__dict__ = value + g = RawGreenlet(f) + self.assertEqual(g.__dict__, {}) + g.switch() + self.assertEqual(g.test, 42) + self.assertEqual(g.__dict__, {'test': 42}) + g.__dict__ = g.__dict__ + self.assertEqual(g.__dict__, {'test': 42}) + self.assertRaises(TypeError, deldict, g) + self.assertRaises(TypeError, setdict, g, 42) + + def test_running_greenlet_has_no_run(self): + has_run = [] + def func(): + has_run.append( + hasattr(greenlet.getcurrent(), 'run') + ) + + g = RawGreenlet(func) + g.switch() + self.assertEqual(has_run, [False]) + + def test_deepcopy(self): + import copy + self.assertRaises(TypeError, copy.copy, RawGreenlet()) + self.assertRaises(TypeError, copy.deepcopy, RawGreenlet()) + + def test_parent_restored_on_kill(self): + hub = RawGreenlet(lambda: None) + main = greenlet.getcurrent() + result = [] + def worker(): + try: + # Wait to be killed by going back to the test. + main.switch() + except greenlet.GreenletExit: + # Resurrect and switch to parent + result.append(greenlet.getcurrent().parent) + result.append(greenlet.getcurrent()) + hub.switch() + g = RawGreenlet(worker, parent=hub) + g.switch() + # delete the only reference, thereby raising GreenletExit + del g + self.assertTrue(result) + self.assertIs(result[0], main) + self.assertIs(result[1].parent, hub) + # Delete them, thereby breaking the cycle between the greenlet + # and the frame, which otherwise would never be collectable + # XXX: We should be able to automatically fix this. + del result[:] + hub = None + main = None + + def test_parent_return_failure(self): + # No run causes AttributeError on switch + g1 = RawGreenlet() + # Greenlet that implicitly switches to parent + g2 = RawGreenlet(lambda: None, parent=g1) + # AttributeError should propagate to us, no fatal errors + with self.assertRaises(AttributeError): + g2.switch() + + def test_throw_exception_not_lost(self): + class mygreenlet(RawGreenlet): + def __getattribute__(self, name): + try: + raise Exception # pylint:disable=broad-exception-raised + except: # pylint:disable=bare-except + pass + return RawGreenlet.__getattribute__(self, name) + g = mygreenlet(lambda: None) + self.assertRaises(SomeError, g.throw, SomeError()) + + @fails_leakcheck + def _do_test_throw_to_dead_thread_doesnt_crash(self, wait_for_cleanup=False): + result = [] + def worker(): + greenlet.getcurrent().parent.switch() + + def creator(): + g = RawGreenlet(worker) + g.switch() + result.append(g) + if wait_for_cleanup: + # Let this greenlet eventually be cleaned up. + g.switch() + greenlet.getcurrent() + t = threading.Thread(target=creator) + t.start() + t.join(10) + del t + # But, depending on the operating system, the thread + # deallocator may not actually have run yet! So we can't be + # sure about the error message unless we wait. + if wait_for_cleanup: + self.wait_for_pending_cleanups() + with self.assertRaises(greenlet.error) as exc: + result[0].throw(SomeError) + + if not wait_for_cleanup: + s = str(exc.exception) + self.assertTrue( + s == "cannot switch to a different thread (which happens to have exited)" + or 'Cannot switch' in s + ) + else: + self.assertEqual( + str(exc.exception), + "cannot switch to a different thread (which happens to have exited)", + ) + + if hasattr(result[0].gr_frame, 'clear'): + # The frame is actually executing (it thinks), we can't clear it. + with self.assertRaises(RuntimeError): + result[0].gr_frame.clear() + # Unfortunately, this doesn't actually clear the references, they're in the + # fast local array. + if not wait_for_cleanup: + # f_locals has no clear method in Python 3.13 + if hasattr(result[0].gr_frame.f_locals, 'clear'): + result[0].gr_frame.f_locals.clear() + else: + self.assertIsNone(result[0].gr_frame) + + del creator + worker = None + del result[:] + # XXX: we ought to be able to automatically fix this. + # See issue 252 + self.expect_greenlet_leak = True # direct us not to wait for it to go away + + @fails_leakcheck + def test_throw_to_dead_thread_doesnt_crash(self): + self._do_test_throw_to_dead_thread_doesnt_crash() + + def test_throw_to_dead_thread_doesnt_crash_wait(self): + self._do_test_throw_to_dead_thread_doesnt_crash(True) + + @fails_leakcheck + def test_recursive_startup(self): + class convoluted(RawGreenlet): + def __init__(self): + RawGreenlet.__init__(self) + self.count = 0 + def __getattribute__(self, name): + if name == 'run' and self.count == 0: + self.count = 1 + self.switch(43) + return RawGreenlet.__getattribute__(self, name) + def run(self, value): + while True: + self.parent.switch(value) + g = convoluted() + self.assertEqual(g.switch(42), 43) + # Exits the running greenlet, otherwise it leaks + # XXX: We should be able to automatically fix this + #g.throw(greenlet.GreenletExit) + #del g + self.expect_greenlet_leak = True + + def test_threaded_updatecurrent(self): + # released when main thread should execute + lock1 = threading.Lock() + lock1.acquire() + # released when another thread should execute + lock2 = threading.Lock() + lock2.acquire() + class finalized(object): + def __del__(self): + # happens while in green_updatecurrent() in main greenlet + # should be very careful not to accidentally call it again + # at the same time we must make sure another thread executes + lock2.release() + lock1.acquire() + # now ts_current belongs to another thread + def deallocator(): + greenlet.getcurrent().parent.switch() + def fthread(): + lock2.acquire() + greenlet.getcurrent() + del g[0] + lock1.release() + lock2.acquire() + greenlet.getcurrent() + lock1.release() + main = greenlet.getcurrent() + g = [RawGreenlet(deallocator)] + g[0].bomb = finalized() + g[0].switch() + t = threading.Thread(target=fthread) + t.start() + # let another thread grab ts_current and deallocate g[0] + lock2.release() + lock1.acquire() + # this is the corner stone + # getcurrent() will notice that ts_current belongs to another thread + # and start the update process, which would notice that g[0] should + # be deallocated, and that will execute an object's finalizer. Now, + # that object will let another thread run so it can grab ts_current + # again, which would likely crash the interpreter if there's no + # check for this case at the end of green_updatecurrent(). This test + # passes if getcurrent() returns correct result, but it's likely + # to randomly crash if it's not anyway. + self.assertEqual(greenlet.getcurrent(), main) + # wait for another thread to complete, just in case + t.join(10) + + def test_dealloc_switch_args_not_lost(self): + seen = [] + def worker(): + # wait for the value + value = greenlet.getcurrent().parent.switch() + # delete all references to ourself + del worker[0] + initiator.parent = greenlet.getcurrent().parent + # switch to main with the value, but because + # ts_current is the last reference to us we + # return here immediately, where we resurrect ourself. + try: + greenlet.getcurrent().parent.switch(value) + finally: + seen.append(greenlet.getcurrent()) + def initiator(): + return 42 # implicitly falls thru to parent + + worker = [RawGreenlet(worker)] + + worker[0].switch() # prime worker + initiator = RawGreenlet(initiator, worker[0]) + value = initiator.switch() + self.assertTrue(seen) + self.assertEqual(value, 42) + + def test_tuple_subclass(self): + # The point of this test is to see what happens when a custom + # tuple subclass is used as an object passed directly to the C + # function ``green_switch``; part of ``green_switch`` checks + # the ``len()`` of the ``args`` tuple, and that can call back + # into Python. Here, when it calls back into Python, we + # recursively enter ``green_switch`` again. + + # This test is really only relevant on Python 2. The builtin + # `apply` function directly passes the given args tuple object + # to the underlying function, whereas the Python 3 version + # unpacks and repacks into an actual tuple. This could still + # happen using the C API on Python 3 though. We should write a + # builtin version of apply() ourself. + def _apply(func, a, k): + func(*a, **k) + + class mytuple(tuple): + def __len__(self): + greenlet.getcurrent().switch() + return tuple.__len__(self) + args = mytuple() + kwargs = dict(a=42) + def switchapply(): + _apply(greenlet.getcurrent().parent.switch, args, kwargs) + g = RawGreenlet(switchapply) + self.assertEqual(g.switch(), kwargs) + + def test_abstract_subclasses(self): + AbstractSubclass = ABCMeta( + 'AbstractSubclass', + (RawGreenlet,), + {'run': abstractmethod(lambda self: None)}) + + class BadSubclass(AbstractSubclass): + pass + + class GoodSubclass(AbstractSubclass): + def run(self): + pass + + GoodSubclass() # should not raise + self.assertRaises(TypeError, BadSubclass) + + def test_implicit_parent_with_threads(self): + if not gc.isenabled(): + return # cannot test with disabled gc + N = gc.get_threshold()[0] + if N < 50: + return # cannot test with such a small N + def attempt(): + lock1 = threading.Lock() + lock1.acquire() + lock2 = threading.Lock() + lock2.acquire() + recycled = [False] + def another_thread(): + lock1.acquire() # wait for gc + greenlet.getcurrent() # update ts_current + lock2.release() # release gc + t = threading.Thread(target=another_thread) + t.start() + class gc_callback(object): + def __del__(self): + lock1.release() + lock2.acquire() + recycled[0] = True + class garbage(object): + def __init__(self): + self.cycle = self + self.callback = gc_callback() + l = [] + x = range(N*2) + current = greenlet.getcurrent() + g = garbage() + for _ in x: + g = None # lose reference to garbage + if recycled[0]: + # gc callback called prematurely + t.join(10) + return False + last = RawGreenlet() + if recycled[0]: + break # yes! gc called in green_new + l.append(last) # increase allocation counter + else: + # gc callback not called when expected + gc.collect() + if recycled[0]: + t.join(10) + return False + self.assertEqual(last.parent, current) + for g in l: + self.assertEqual(g.parent, current) + return True + for _ in range(5): + if attempt(): + break + + def test_issue_245_reference_counting_subclass_no_threads(self): + # https://github.com/python-greenlet/greenlet/issues/245 + # Before the fix, this crashed pretty reliably on + # Python 3.10, at least on macOS; but much less reliably on other + # interpreters (memory layout must have changed). + # The threaded test crashed more reliably on more interpreters. + from greenlet import getcurrent + from greenlet import GreenletExit + + class Greenlet(RawGreenlet): + pass + + initial_refs = sys.getrefcount(Greenlet) + # This has to be an instance variable because + # Python 2 raises a SyntaxError if we delete a local + # variable referenced in an inner scope. + self.glets = [] # pylint:disable=attribute-defined-outside-init + + def greenlet_main(): + try: + getcurrent().parent.switch() + except GreenletExit: + self.glets.append(getcurrent()) + + # Before the + for _ in range(10): + Greenlet(greenlet_main).switch() + + del self.glets + self.assertEqual(sys.getrefcount(Greenlet), initial_refs) + + @unittest.skipIf( + PY313 and RUNNING_ON_MANYLINUX, + "The manylinux images appear to hang on this test on 3.13rc2" + # Or perhaps I just got tired of waiting for the 450s timeout. + # Still, it shouldn't take anywhere near that long. Does not reproduce in + # Ubuntu images, on macOS or Windows. + ) + def test_issue_245_reference_counting_subclass_threads(self): + # https://github.com/python-greenlet/greenlet/issues/245 + from threading import Thread + from threading import Event + + from greenlet import getcurrent + + class MyGreenlet(RawGreenlet): + pass + + glets = [] + ref_cleared = Event() + + def greenlet_main(): + getcurrent().parent.switch() + + def thread_main(greenlet_running_event): + mine = MyGreenlet(greenlet_main) + glets.append(mine) + # The greenlets being deleted must be active + mine.switch() + # Don't keep any reference to it in this thread + del mine + # Let main know we published our greenlet. + greenlet_running_event.set() + # Wait for main to let us know the references are + # gone and the greenlet objects no longer reachable + ref_cleared.wait(10) + # The creating thread must call getcurrent() (or a few other + # greenlet APIs) because that's when the thread-local list of dead + # greenlets gets cleared. + getcurrent() + + # We start with 3 references to the subclass: + # - This module + # - Its __mro__ + # - The __subclassess__ attribute of greenlet + # - (If we call gc.get_referents(), we find four entries, including + # some other tuple ``(greenlet)`` that I'm not sure about but must be part + # of the machinery.) + # + # On Python 3.10 it's often enough to just run 3 threads; on Python 2.7, + # more threads are needed, and the results are still + # non-deterministic. Presumably the memory layouts are different + initial_refs = sys.getrefcount(MyGreenlet) + thread_ready_events = [] + for _ in range( + initial_refs + 45 + ): + event = Event() + thread = Thread(target=thread_main, args=(event,)) + thread_ready_events.append(event) + thread.start() + + + for done_event in thread_ready_events: + done_event.wait(10) + + + del glets[:] + ref_cleared.set() + # Let any other thread run; it will crash the interpreter + # if not fixed (or silently corrupt memory and we possibly crash + # later). + self.wait_for_pending_cleanups() + self.assertEqual(sys.getrefcount(MyGreenlet), initial_refs) + + def test_falling_off_end_switches_to_unstarted_parent_raises_error(self): + def no_args(): + return 13 + + parent_never_started = RawGreenlet(no_args) + + def leaf(): + return 42 + + child = RawGreenlet(leaf, parent_never_started) + + # Because the run function takes to arguments + with self.assertRaises(TypeError): + child.switch() + + def test_falling_off_end_switches_to_unstarted_parent_works(self): + def one_arg(x): + return (x, 24) + + parent_never_started = RawGreenlet(one_arg) + + def leaf(): + return 42 + + child = RawGreenlet(leaf, parent_never_started) + + result = child.switch() + self.assertEqual(result, (42, 24)) + + def test_switch_to_dead_greenlet_with_unstarted_perverse_parent(self): + class Parent(RawGreenlet): + def __getattribute__(self, name): + if name == 'run': + raise SomeError + + + parent_never_started = Parent() + seen = [] + child = RawGreenlet(lambda: seen.append(42), parent_never_started) + # Because we automatically start the parent when the child is + # finished + with self.assertRaises(SomeError): + child.switch() + + self.assertEqual(seen, [42]) + + with self.assertRaises(SomeError): + child.switch() + self.assertEqual(seen, [42]) + + def test_switch_to_dead_greenlet_reparent(self): + seen = [] + parent_never_started = RawGreenlet(lambda: seen.append(24)) + child = RawGreenlet(lambda: seen.append(42)) + + child.switch() + self.assertEqual(seen, [42]) + + child.parent = parent_never_started + # This actually is the same as switching to the parent. + result = child.switch() + self.assertIsNone(result) + self.assertEqual(seen, [42, 24]) + + def test_can_access_f_back_of_suspended_greenlet(self): + # This tests our frame rewriting to work around Python 3.12+ having + # some interpreter frames on the C stack. It will crash in the absence + # of that logic. + main = greenlet.getcurrent() + + def outer(): + inner() + + def inner(): + main.switch(sys._getframe(0)) + + hub = RawGreenlet(outer) + # start it + hub.switch() + + # start another greenlet to make sure we aren't relying on + # anything in `hub` still being on the C stack + unrelated = RawGreenlet(lambda: None) + unrelated.switch() + + # now it is suspended + self.assertIsNotNone(hub.gr_frame) + self.assertEqual(hub.gr_frame.f_code.co_name, "inner") + self.assertIsNotNone(hub.gr_frame.f_back) + self.assertEqual(hub.gr_frame.f_back.f_code.co_name, "outer") + # The next line is what would crash + self.assertIsNone(hub.gr_frame.f_back.f_back) + + def test_get_stack_with_nested_c_calls(self): + from functools import partial + from . import _test_extension_cpp + + def recurse(v): + if v > 0: + return v * _test_extension_cpp.test_call(partial(recurse, v - 1)) + return greenlet.getcurrent().parent.switch() + + gr = RawGreenlet(recurse) + gr.switch(5) + frame = gr.gr_frame + for i in range(5): + self.assertEqual(frame.f_locals["v"], i) + frame = frame.f_back + self.assertEqual(frame.f_locals["v"], 5) + self.assertIsNone(frame.f_back) + self.assertEqual(gr.switch(10), 1200) # 1200 = 5! * 10 + + def test_frames_always_exposed(self): + # On Python 3.12 this will crash if we don't set the + # gr_frames_always_exposed attribute. More background: + # https://github.com/python-greenlet/greenlet/issues/388 + main = greenlet.getcurrent() + + def outer(): + inner(sys._getframe(0)) + + def inner(frame): + main.switch(frame) + + gr = RawGreenlet(outer) + frame = gr.switch() + + # Do something else to clobber the part of the C stack used by `gr`, + # so we can't skate by on "it just happened to still be there" + unrelated = RawGreenlet(lambda: None) + unrelated.switch() + + self.assertEqual(frame.f_code.co_name, "outer") + # The next line crashes on 3.12 if we haven't exposed the frames. + self.assertIsNone(frame.f_back) + + +class TestGreenletSetParentErrors(TestCase): + def test_threaded_reparent(self): + data = {} + created_event = threading.Event() + done_event = threading.Event() + + def run(): + data['g'] = RawGreenlet(lambda: None) + created_event.set() + done_event.wait(10) + + def blank(): + greenlet.getcurrent().parent.switch() + + thread = threading.Thread(target=run) + thread.start() + created_event.wait(10) + g = RawGreenlet(blank) + g.switch() + with self.assertRaises(ValueError) as exc: + g.parent = data['g'] + done_event.set() + thread.join(10) + + self.assertEqual(str(exc.exception), "parent cannot be on a different thread") + + def test_unexpected_reparenting(self): + another = [] + def worker(): + g = RawGreenlet(lambda: None) + another.append(g) + g.switch() + t = threading.Thread(target=worker) + t.start() + t.join(10) + # The first time we switch (running g_initialstub(), which is + # when we look up the run attribute) we attempt to change the + # parent to one from another thread (which also happens to be + # dead). ``g_initialstub()`` should detect this and raise a + # greenlet error. + # + # EXCEPT: With the fix for #252, this is actually detected + # sooner, when setting the parent itself. Prior to that fix, + # the main greenlet from the background thread kept a valid + # value for ``run_info``, and appeared to be a valid parent + # until we actually started the greenlet. But now that it's + # cleared, this test is catching whether ``green_setparent`` + # can detect the dead thread. + # + # Further refactoring once again changes this back to a greenlet.error + # + # We need to wait for the cleanup to happen, but we're + # deliberately leaking a main greenlet here. + self.wait_for_pending_cleanups(initial_main_greenlets=self.main_greenlets_before_test + 1) + + class convoluted(RawGreenlet): + def __getattribute__(self, name): + if name == 'run': + self.parent = another[0] # pylint:disable=attribute-defined-outside-init + return RawGreenlet.__getattribute__(self, name) + g = convoluted(lambda: None) + with self.assertRaises(greenlet.error) as exc: + g.switch() + self.assertEqual(str(exc.exception), + "cannot switch to a different thread (which happens to have exited)") + del another[:] + + def test_unexpected_reparenting_thread_running(self): + # Like ``test_unexpected_reparenting``, except the background thread is + # actually still alive. + another = [] + switched_to_greenlet = threading.Event() + keep_main_alive = threading.Event() + def worker(): + g = RawGreenlet(lambda: None) + another.append(g) + g.switch() + switched_to_greenlet.set() + keep_main_alive.wait(10) + class convoluted(RawGreenlet): + def __getattribute__(self, name): + if name == 'run': + self.parent = another[0] # pylint:disable=attribute-defined-outside-init + return RawGreenlet.__getattribute__(self, name) + + t = threading.Thread(target=worker) + t.start() + + switched_to_greenlet.wait(10) + try: + g = convoluted(lambda: None) + + with self.assertRaises(greenlet.error) as exc: + g.switch() + self.assertIn("Cannot switch to a different thread", str(exc.exception)) + self.assertIn("Expected", str(exc.exception)) + self.assertIn("Current", str(exc.exception)) + finally: + keep_main_alive.set() + t.join(10) + # XXX: Should handle this automatically. + del another[:] + + def test_cannot_delete_parent(self): + worker = RawGreenlet(lambda: None) + self.assertIs(worker.parent, greenlet.getcurrent()) + + with self.assertRaises(AttributeError) as exc: + del worker.parent + self.assertEqual(str(exc.exception), "can't delete attribute") + + def test_cannot_delete_parent_of_main(self): + with self.assertRaises(AttributeError) as exc: + del greenlet.getcurrent().parent + self.assertEqual(str(exc.exception), "can't delete attribute") + + + def test_main_greenlet_parent_is_none(self): + # assuming we're in a main greenlet here. + self.assertIsNone(greenlet.getcurrent().parent) + + def test_set_parent_wrong_types(self): + def bg(): + # Go back to main. + greenlet.getcurrent().parent.switch() + + def check(glet): + for p in None, 1, self, "42": + with self.assertRaises(TypeError) as exc: + glet.parent = p + + self.assertEqual( + str(exc.exception), + "GreenletChecker: Expected any type of greenlet, not " + type(p).__name__) + + # First, not running + g = RawGreenlet(bg) + self.assertFalse(g) + check(g) + + # Then when running. + g.switch() + self.assertTrue(g) + check(g) + + # Let it finish + g.switch() + + + def test_trivial_cycle(self): + glet = RawGreenlet(lambda: None) + with self.assertRaises(ValueError) as exc: + glet.parent = glet + self.assertEqual(str(exc.exception), "cyclic parent chain") + + def test_trivial_cycle_main(self): + # This used to produce a ValueError, but we catch it earlier than that now. + with self.assertRaises(AttributeError) as exc: + greenlet.getcurrent().parent = greenlet.getcurrent() + self.assertEqual(str(exc.exception), "cannot set the parent of a main greenlet") + + def test_deeper_cycle(self): + g1 = RawGreenlet(lambda: None) + g2 = RawGreenlet(lambda: None) + g3 = RawGreenlet(lambda: None) + + g1.parent = g2 + g2.parent = g3 + with self.assertRaises(ValueError) as exc: + g3.parent = g1 + self.assertEqual(str(exc.exception), "cyclic parent chain") + + +class TestRepr(TestCase): + + def assertEndsWith(self, got, suffix): + self.assertTrue(got.endswith(suffix), (got, suffix)) + + def test_main_while_running(self): + r = repr(greenlet.getcurrent()) + self.assertEndsWith(r, " current active started main>") + + def test_main_in_background(self): + main = greenlet.getcurrent() + def run(): + return repr(main) + + g = RawGreenlet(run) + r = g.switch() + self.assertEndsWith(r, ' suspended active started main>') + + def test_initial(self): + r = repr(RawGreenlet()) + self.assertEndsWith(r, ' pending>') + + def test_main_from_other_thread(self): + main = greenlet.getcurrent() + + class T(threading.Thread): + original_main = thread_main = None + main_glet = None + def run(self): + self.original_main = repr(main) + self.main_glet = greenlet.getcurrent() + self.thread_main = repr(self.main_glet) + + t = T() + t.start() + t.join(10) + + self.assertEndsWith(t.original_main, ' suspended active started main>') + self.assertEndsWith(t.thread_main, ' current active started main>') + # give the machinery time to notice the death of the thread, + # and clean it up. Note that we don't use + # ``expect_greenlet_leak`` or wait_for_pending_cleanups, + # because at this point we know we have an extra greenlet + # still reachable. + for _ in range(3): + time.sleep(0.001) + + # In the past, main greenlets, even from dead threads, never + # really appear dead. We have fixed that, and we also report + # that the thread is dead in the repr. (Do this multiple times + # to make sure that we don't self-modify and forget our state + # in the C++ code). + for _ in range(3): + self.assertTrue(t.main_glet.dead) + r = repr(t.main_glet) + self.assertEndsWith(r, ' (thread exited) dead>') + + def test_dead(self): + g = RawGreenlet(lambda: None) + g.switch() + self.assertEndsWith(repr(g), ' dead>') + self.assertNotIn('suspended', repr(g)) + self.assertNotIn('started', repr(g)) + self.assertNotIn('active', repr(g)) + + def test_formatting_produces_native_str(self): + # https://github.com/python-greenlet/greenlet/issues/218 + # %s formatting on Python 2 was producing unicode, not str. + + g_dead = RawGreenlet(lambda: None) + g_not_started = RawGreenlet(lambda: None) + g_cur = greenlet.getcurrent() + + for g in g_dead, g_not_started, g_cur: + + self.assertIsInstance( + '%s' % (g,), + str + ) + self.assertIsInstance( + '%r' % (g,), + str, + ) + + +class TestMainGreenlet(TestCase): + # Tests some implementation details, and relies on some + # implementation details. + + def _check_current_is_main(self): + # implementation detail + assert 'main' in repr(greenlet.getcurrent()) + + t = type(greenlet.getcurrent()) + assert 'main' not in repr(t) + return t + + def test_main_greenlet_type_can_be_subclassed(self): + main_type = self._check_current_is_main() + subclass = type('subclass', (main_type,), {}) + self.assertIsNotNone(subclass) + + def test_main_greenlet_is_greenlet(self): + self._check_current_is_main() + self.assertIsInstance(greenlet.getcurrent(), RawGreenlet) + + + +class TestBrokenGreenlets(TestCase): + # Tests for things that used to, or still do, terminate the interpreter. + # This often means doing unsavory things. + + def test_failed_to_initialstub(self): + def func(): + raise AssertionError("Never get here") + + + g = greenlet._greenlet.UnswitchableGreenlet(func) + g.force_switch_error = True + + with self.assertRaisesRegex(SystemError, + "Failed to switch stacks into a greenlet for the first time."): + g.switch() + + def test_failed_to_switch_into_running(self): + runs = [] + def func(): + runs.append(1) + greenlet.getcurrent().parent.switch() + runs.append(2) + greenlet.getcurrent().parent.switch() + runs.append(3) # pragma: no cover + + g = greenlet._greenlet.UnswitchableGreenlet(func) + g.switch() + self.assertEqual(runs, [1]) + g.switch() + self.assertEqual(runs, [1, 2]) + g.force_switch_error = True + + with self.assertRaisesRegex(SystemError, + "Failed to switch stacks into a running greenlet."): + g.switch() + + # If we stopped here, we would fail the leakcheck, because we've left + # the ``inner_bootstrap()`` C frame and its descendents hanging around, + # which have a bunch of Python references. They'll never get cleaned up + # if we don't let the greenlet finish. + g.force_switch_error = False + g.switch() + self.assertEqual(runs, [1, 2, 3]) + + def test_failed_to_slp_switch_into_running(self): + ex = self.assertScriptRaises('fail_slp_switch.py') + + self.assertIn('fail_slp_switch is running', ex.output) + self.assertIn(ex.returncode, self.get_expected_returncodes_for_aborted_process()) + + def test_reentrant_switch_two_greenlets(self): + # Before we started capturing the arguments in g_switch_finish, this could crash. + output = self.run_script('fail_switch_two_greenlets.py') + self.assertIn('In g1_run', output) + self.assertIn('TRACE', output) + self.assertIn('LEAVE TRACE', output) + self.assertIn('Falling off end of main', output) + self.assertIn('Falling off end of g1_run', output) + self.assertIn('Falling off end of g2', output) + + def test_reentrant_switch_three_greenlets(self): + # On debug builds of greenlet, this used to crash with an assertion error; + # on non-debug versions, it ran fine (which it should not do!). + # Now it always crashes correctly with a TypeError + ex = self.assertScriptRaises('fail_switch_three_greenlets.py', exitcodes=(1,)) + + self.assertIn('TypeError', ex.output) + self.assertIn('positional arguments', ex.output) + + def test_reentrant_switch_three_greenlets2(self): + # This actually passed on debug and non-debug builds. It + # should probably have been triggering some debug assertions + # but it didn't. + # + # I think the fixes for the above test also kicked in here. + output = self.run_script('fail_switch_three_greenlets2.py') + self.assertIn( + "RESULTS: [('trace', 'switch'), " + "('trace', 'switch'), ('g2 arg', 'g2 from tracefunc'), " + "('trace', 'switch'), ('main g1', 'from g2_run'), ('trace', 'switch'), " + "('g1 arg', 'g1 from main'), ('trace', 'switch'), ('main g2', 'from g1_run'), " + "('trace', 'switch'), ('g1 from parent', 'g1 from main 2'), ('trace', 'switch'), " + "('main g1.2', 'g1 done'), ('trace', 'switch'), ('g2 from parent', ()), " + "('trace', 'switch'), ('main g2.2', 'g2 done')]", + output + ) + + def test_reentrant_switch_GreenletAlreadyStartedInPython(self): + output = self.run_script('fail_initialstub_already_started.py') + + self.assertIn( + "RESULTS: ['Begin C', 'Switch to b from B.__getattribute__ in C', " + "('Begin B', ()), '_B_run switching to main', ('main from c', 'From B'), " + "'B.__getattribute__ back from main in C', ('Begin A', (None,)), " + "('A dead?', True, 'B dead?', True, 'C dead?', False), " + "'C done', ('main from c.2', None)]", + output + ) + + def test_reentrant_switch_run_callable_has_del(self): + output = self.run_script('fail_clearing_run_switches.py') + self.assertIn( + "RESULTS [" + "('G.__getattribute__', 'run'), ('RunCallable', '__del__'), " + "('main: g.switch()', 'from RunCallable'), ('run_func', 'enter')" + "]", + output + ) + +if __name__ == '__main__': + unittest.main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_greenlet_trash.py b/.venv/Lib/site-packages/greenlet/tests/test_greenlet_trash.py new file mode 100644 index 0000000..c1fc137 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_greenlet_trash.py @@ -0,0 +1,187 @@ +# -*- coding: utf-8 -*- +""" +Tests for greenlets interacting with the CPython trash can API. + +The CPython trash can API is not designed to be re-entered from a +single thread. But this can happen using greenlets, if something +during the object deallocation process switches greenlets, and this second +greenlet then causes the trash can to get entered again. Here, we do this +very explicitly, but in other cases (like gevent) it could be arbitrarily more +complicated: for example, a weakref callback might try to acquire a lock that's +already held by another greenlet; that would allow a greenlet switch to occur. + +See https://github.com/gevent/gevent/issues/1909 + +This test is fragile and relies on details of the CPython +implementation (like most of the rest of this package): + + - We enter the trashcan and deferred deallocation after + ``_PyTrash_UNWIND_LEVEL`` calls. This constant, defined in + CPython's object.c, is generally 50. That's basically how many objects are required to + get us into the deferred deallocation situation. + + - The test fails by hitting an ``assert()`` in object.c; if the + build didn't enable assert, then we don't catch this. + + - If the test fails in that way, the interpreter crashes. +""" +from __future__ import print_function, absolute_import, division + +import unittest + + +class TestTrashCanReEnter(unittest.TestCase): + + def test_it(self): + try: + # pylint:disable-next=no-name-in-module + from greenlet._greenlet import get_tstate_trash_delete_nesting # pylint:disable=unused-import + except ImportError: + import sys + # Python 3.13 has not "trash delete nesting" anymore (but "delete later") + assert sys.version_info[:2] >= (3, 13) + self.skipTest("get_tstate_trash_delete_nesting is not available.") + + # Try several times to trigger it, because it isn't 100% + # reliable. + for _ in range(10): + self.check_it() + + def check_it(self): # pylint:disable=too-many-statements + import greenlet + from greenlet._greenlet import get_tstate_trash_delete_nesting # pylint:disable=no-name-in-module + main = greenlet.getcurrent() + + assert get_tstate_trash_delete_nesting() == 0 + + # We expect to be in deferred deallocation after this many + # deallocations have occurred. TODO: I wish we had a better way to do + # this --- that was before get_tstate_trash_delete_nesting; perhaps + # we can use that API to do better? + TRASH_UNWIND_LEVEL = 50 + # How many objects to put in a container; it's the container that + # queues objects for deferred deallocation. + OBJECTS_PER_CONTAINER = 500 + + class Dealloc: # define the class here because we alter class variables each time we run. + """ + An object with a ``__del__`` method. When it starts getting deallocated + from a deferred trash can run, it switches greenlets, allocates more objects + which then also go in the trash can. If we don't save state appropriately, + nesting gets out of order and we can crash the interpreter. + """ + + #: Has our deallocation actually run and switched greenlets? + #: When it does, this will be set to the current greenlet. This should + #: be happening in the main greenlet, so we check that down below. + SPAWNED = False + + #: Has the background greenlet run? + BG_RAN = False + + BG_GLET = None + + #: How many of these things have ever been allocated. + CREATED = 0 + + #: How many of these things have ever been deallocated. + DESTROYED = 0 + + #: How many were destroyed not in the main greenlet. There should always + #: be some. + #: If the test is broken or things change in the trashcan implementation, + #: this may not be correct. + DESTROYED_BG = 0 + + def __init__(self, sequence_number): + """ + :param sequence_number: The ordinal of this object during + one particular creation run. This is used to detect (guess, really) + when we have entered the trash can's deferred deallocation. + """ + self.i = sequence_number + Dealloc.CREATED += 1 + + def __del__(self): + if self.i == TRASH_UNWIND_LEVEL and not self.SPAWNED: + Dealloc.SPAWNED = greenlet.getcurrent() + other = Dealloc.BG_GLET = greenlet.greenlet(background_greenlet) + x = other.switch() + assert x == 42 + # It's important that we don't switch back to the greenlet, + # we leave it hanging there in an incomplete state. But we don't let it + # get collected, either. If we complete it now, while we're still + # in the scope of the initial trash can, things work out and we + # don't see the problem. We need this greenlet to complete + # at some point in the future, after we've exited this trash can invocation. + del other + elif self.i == 40 and greenlet.getcurrent() is not main: + Dealloc.BG_RAN = True + try: + main.switch(42) + except greenlet.GreenletExit as ex: + # We expect this; all references to us go away + # while we're still running, and we need to finish deleting + # ourself. + Dealloc.BG_RAN = type(ex) + del ex + + # Record the fact that we're dead last of all. This ensures that + # we actually get returned too. + Dealloc.DESTROYED += 1 + if greenlet.getcurrent() is not main: + Dealloc.DESTROYED_BG += 1 + + + def background_greenlet(): + # We direct through a second function, instead of + # directly calling ``make_some()``, so that we have complete + # control over when these objects are destroyed: we need them + # to be destroyed in the context of the background greenlet + t = make_some() + del t # Triggere deletion. + + def make_some(): + t = () + i = OBJECTS_PER_CONTAINER + while i: + # Nest the tuples; it's the recursion that gets us + # into trash. + t = (Dealloc(i), t) + i -= 1 + return t + + + some = make_some() + self.assertEqual(Dealloc.CREATED, OBJECTS_PER_CONTAINER) + self.assertEqual(Dealloc.DESTROYED, 0) + + # If we're going to crash, it should be on the following line. + # We only crash if ``assert()`` is enabled, of course. + del some + + # For non-debug builds of CPython, we won't crash. The best we can do is check + # the nesting level explicitly. + self.assertEqual(0, get_tstate_trash_delete_nesting()) + + # Discard this, raising GreenletExit into where it is waiting. + Dealloc.BG_GLET = None + # The same nesting level maintains. + self.assertEqual(0, get_tstate_trash_delete_nesting()) + + # We definitely cleaned some up in the background + self.assertGreater(Dealloc.DESTROYED_BG, 0) + + # Make sure all the cleanups happened. + self.assertIs(Dealloc.SPAWNED, main) + self.assertTrue(Dealloc.BG_RAN) + self.assertEqual(Dealloc.BG_RAN, greenlet.GreenletExit) + self.assertEqual(Dealloc.CREATED, Dealloc.DESTROYED ) + self.assertEqual(Dealloc.CREATED, OBJECTS_PER_CONTAINER * 2) + + import gc + gc.collect() + + +if __name__ == '__main__': + unittest.main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_leaks.py b/.venv/Lib/site-packages/greenlet/tests/test_leaks.py new file mode 100644 index 0000000..ed1fa71 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_leaks.py @@ -0,0 +1,443 @@ +# -*- coding: utf-8 -*- +""" +Testing scenarios that may have leaked. +""" +from __future__ import print_function, absolute_import, division + +import sys +import gc + +import time +import weakref +import threading + + +import greenlet +from . import TestCase +from .leakcheck import fails_leakcheck +from .leakcheck import ignores_leakcheck +from .leakcheck import RUNNING_ON_MANYLINUX + +# pylint:disable=protected-access + +assert greenlet.GREENLET_USE_GC # Option to disable this was removed in 1.0 + +class HasFinalizerTracksInstances(object): + EXTANT_INSTANCES = set() + def __init__(self, msg): + self.msg = sys.intern(msg) + self.EXTANT_INSTANCES.add(id(self)) + def __del__(self): + self.EXTANT_INSTANCES.remove(id(self)) + def __repr__(self): + return "" % ( + id(self), self.msg + ) + @classmethod + def reset(cls): + cls.EXTANT_INSTANCES.clear() + + +class TestLeaks(TestCase): + + def test_arg_refs(self): + args = ('a', 'b', 'c') + refcount_before = sys.getrefcount(args) + # pylint:disable=unnecessary-lambda + g = greenlet.greenlet( + lambda *args: greenlet.getcurrent().parent.switch(*args)) + for _ in range(100): + g.switch(*args) + self.assertEqual(sys.getrefcount(args), refcount_before) + + def test_kwarg_refs(self): + kwargs = {} + # pylint:disable=unnecessary-lambda + g = greenlet.greenlet( + lambda **kwargs: greenlet.getcurrent().parent.switch(**kwargs)) + for _ in range(100): + g.switch(**kwargs) + self.assertEqual(sys.getrefcount(kwargs), 2) + + + @staticmethod + def __recycle_threads(): + # By introducing a thread that does sleep we allow other threads, + # that have triggered their __block condition, but did not have a + # chance to deallocate their thread state yet, to finally do so. + # The way it works is by requiring a GIL switch (different thread), + # which does a GIL release (sleep), which might do a GIL switch + # to finished threads and allow them to clean up. + def worker(): + time.sleep(0.001) + t = threading.Thread(target=worker) + t.start() + time.sleep(0.001) + t.join(10) + + def test_threaded_leak(self): + gg = [] + def worker(): + # only main greenlet present + gg.append(weakref.ref(greenlet.getcurrent())) + for _ in range(2): + t = threading.Thread(target=worker) + t.start() + t.join(10) + del t + greenlet.getcurrent() # update ts_current + self.__recycle_threads() + greenlet.getcurrent() # update ts_current + gc.collect() + greenlet.getcurrent() # update ts_current + for g in gg: + self.assertIsNone(g()) + + def test_threaded_adv_leak(self): + gg = [] + def worker(): + # main and additional *finished* greenlets + ll = greenlet.getcurrent().ll = [] + def additional(): + ll.append(greenlet.getcurrent()) + for _ in range(2): + greenlet.greenlet(additional).switch() + gg.append(weakref.ref(greenlet.getcurrent())) + for _ in range(2): + t = threading.Thread(target=worker) + t.start() + t.join(10) + del t + greenlet.getcurrent() # update ts_current + self.__recycle_threads() + greenlet.getcurrent() # update ts_current + gc.collect() + greenlet.getcurrent() # update ts_current + for g in gg: + self.assertIsNone(g()) + + def assertClocksUsed(self): + used = greenlet._greenlet.get_clocks_used_doing_optional_cleanup() + self.assertGreaterEqual(used, 0) + # we don't lose the value + greenlet._greenlet.enable_optional_cleanup(True) + used2 = greenlet._greenlet.get_clocks_used_doing_optional_cleanup() + self.assertEqual(used, used2) + self.assertGreater(greenlet._greenlet.CLOCKS_PER_SEC, 1) + + def _check_issue251(self, + manually_collect_background=True, + explicit_reference_to_switch=False): + # See https://github.com/python-greenlet/greenlet/issues/251 + # Killing a greenlet (probably not the main one) + # in one thread from another thread would + # result in leaking a list (the ts_delkey list). + # We no longer use lists to hold that stuff, though. + + # For the test to be valid, even empty lists have to be tracked by the + # GC + + assert gc.is_tracked([]) + HasFinalizerTracksInstances.reset() + greenlet.getcurrent() + greenlets_before = self.count_objects(greenlet.greenlet, exact_kind=False) + + background_glet_running = threading.Event() + background_glet_killed = threading.Event() + background_greenlets = [] + + # XXX: Switching this to a greenlet subclass that overrides + # run results in all callers failing the leaktest; that + # greenlet instance is leaked. There's a bound method for + # run() living on the stack of the greenlet in g_initialstub, + # and since we don't manually switch back to the background + # greenlet to let it "fall off the end" and exit the + # g_initialstub function, it never gets cleaned up. Making the + # garbage collector aware of this bound method (making it an + # attribute of the greenlet structure and traversing into it) + # doesn't help, for some reason. + def background_greenlet(): + # Throw control back to the main greenlet. + jd = HasFinalizerTracksInstances("DELETING STACK OBJECT") + greenlet._greenlet.set_thread_local( + 'test_leaks_key', + HasFinalizerTracksInstances("DELETING THREAD STATE")) + # Explicitly keeping 'switch' in a local variable + # breaks this test in all versions + if explicit_reference_to_switch: + s = greenlet.getcurrent().parent.switch + s([jd]) + else: + greenlet.getcurrent().parent.switch([jd]) + + bg_main_wrefs = [] + + def background_thread(): + glet = greenlet.greenlet(background_greenlet) + bg_main_wrefs.append(weakref.ref(glet.parent)) + + background_greenlets.append(glet) + glet.switch() # Be sure it's active. + # Control is ours again. + del glet # Delete one reference from the thread it runs in. + background_glet_running.set() + background_glet_killed.wait(10) + + # To trigger the background collection of the dead + # greenlet, thus clearing out the contents of the list, we + # need to run some APIs. See issue 252. + if manually_collect_background: + greenlet.getcurrent() + + + t = threading.Thread(target=background_thread) + t.start() + background_glet_running.wait(10) + greenlet.getcurrent() + lists_before = self.count_objects(list, exact_kind=True) + + assert len(background_greenlets) == 1 + self.assertFalse(background_greenlets[0].dead) + # Delete the last reference to the background greenlet + # from a different thread. This puts it in the background thread's + # ts_delkey list. + del background_greenlets[:] + background_glet_killed.set() + + # Now wait for the background thread to die. + t.join(10) + del t + # As part of the fix for 252, we need to cycle the ceval.c + # interpreter loop to be sure it has had a chance to process + # the pending call. + self.wait_for_pending_cleanups() + + lists_after = self.count_objects(list, exact_kind=True) + greenlets_after = self.count_objects(greenlet.greenlet, exact_kind=False) + + # On 2.7, we observe that lists_after is smaller than + # lists_before. No idea what lists got cleaned up. All the + # Python 3 versions match exactly. + self.assertLessEqual(lists_after, lists_before) + # On versions after 3.6, we've successfully cleaned up the + # greenlet references thanks to the internal "vectorcall" + # protocol; prior to that, there is a reference path through + # the ``greenlet.switch`` method still on the stack that we + # can't reach to clean up. The C code goes through terrific + # lengths to clean that up. + if not explicit_reference_to_switch \ + and greenlet._greenlet.get_clocks_used_doing_optional_cleanup() is not None: + # If cleanup was disabled, though, we may not find it. + self.assertEqual(greenlets_after, greenlets_before) + if manually_collect_background: + # TODO: Figure out how to make this work! + # The one on the stack is still leaking somehow + # in the non-manually-collect state. + self.assertEqual(HasFinalizerTracksInstances.EXTANT_INSTANCES, set()) + else: + # The explicit reference prevents us from collecting it + # and it isn't always found by the GC either for some + # reason. The entire frame is leaked somehow, on some + # platforms (e.g., MacPorts builds of Python (all + # versions!)), but not on other platforms (the linux and + # windows builds on GitHub actions and Appveyor). So we'd + # like to write a test that proves that the main greenlet + # sticks around, and we can on my machine (macOS 11.6, + # MacPorts builds of everything) but we can't write that + # same test on other platforms. However, hopefully iteration + # done by leakcheck will find it. + pass + + if greenlet._greenlet.get_clocks_used_doing_optional_cleanup() is not None: + self.assertClocksUsed() + + def test_issue251_killing_cross_thread_leaks_list(self): + self._check_issue251() + + def test_issue251_with_cleanup_disabled(self): + greenlet._greenlet.enable_optional_cleanup(False) + try: + self._check_issue251() + finally: + greenlet._greenlet.enable_optional_cleanup(True) + + @fails_leakcheck + def test_issue251_issue252_need_to_collect_in_background(self): + # Between greenlet 1.1.2 and the next version, this was still + # failing because the leak of the list still exists when we + # don't call a greenlet API before exiting the thread. The + # proximate cause is that neither of the two greenlets from + # the background thread are actually being destroyed, even + # though the GC is in fact visiting both objects. It's not + # clear where that leak is? For some reason the thread-local + # dict holding it isn't being cleaned up. + # + # The leak, I think, is in the CPYthon internal function that + # calls into green_switch(). The argument tuple is still on + # the C stack somewhere and can't be reached? That doesn't + # make sense, because the tuple should be collectable when + # this object goes away. + # + # Note that this test sometimes spuriously passes on Linux, + # for some reason, but I've never seen it pass on macOS. + self._check_issue251(manually_collect_background=False) + + @fails_leakcheck + def test_issue251_issue252_need_to_collect_in_background_cleanup_disabled(self): + self.expect_greenlet_leak = True + greenlet._greenlet.enable_optional_cleanup(False) + try: + self._check_issue251(manually_collect_background=False) + finally: + greenlet._greenlet.enable_optional_cleanup(True) + + @fails_leakcheck + def test_issue251_issue252_explicit_reference_not_collectable(self): + self._check_issue251( + manually_collect_background=False, + explicit_reference_to_switch=True) + + UNTRACK_ATTEMPTS = 100 + + def _only_test_some_versions(self): + # We're only looking for this problem specifically on 3.11, + # and this set of tests is relatively fragile, depending on + # OS and memory management details. So we want to run it on 3.11+ + # (obviously) but not every older 3.x version in order to reduce + # false negatives. At the moment, those false results seem to have + # resolved, so we are actually running this on 3.8+ + assert sys.version_info[0] >= 3 + if sys.version_info[:2] < (3, 8): + self.skipTest('Only observed on 3.11') + if RUNNING_ON_MANYLINUX: + self.skipTest("Slow and not worth repeating here") + + @ignores_leakcheck + # Because we're just trying to track raw memory, not objects, and running + # the leakcheck makes an already slow test slower. + def test_untracked_memory_doesnt_increase(self): + # See https://github.com/gevent/gevent/issues/1924 + # and https://github.com/python-greenlet/greenlet/issues/328 + self._only_test_some_versions() + def f(): + return 1 + + ITER = 10000 + def run_it(): + for _ in range(ITER): + greenlet.greenlet(f).switch() + + # Establish baseline + for _ in range(3): + run_it() + + # uss: (Linux, macOS, Windows): aka "Unique Set Size", this is + # the memory which is unique to a process and which would be + # freed if the process was terminated right now. + uss_before = self.get_process_uss() + + for count in range(self.UNTRACK_ATTEMPTS): + uss_before = max(uss_before, self.get_process_uss()) + run_it() + + uss_after = self.get_process_uss() + if uss_after <= uss_before and count > 1: + break + + self.assertLessEqual(uss_after, uss_before) + + def _check_untracked_memory_thread(self, deallocate_in_thread=True): + self._only_test_some_versions() + # Like the above test, but what if there are a bunch of + # unfinished greenlets in a thread that dies? + # Does it matter if we deallocate in the thread or not? + EXIT_COUNT = [0] + + def f(): + try: + greenlet.getcurrent().parent.switch() + except greenlet.GreenletExit: + EXIT_COUNT[0] += 1 + raise + return 1 + + ITER = 10000 + def run_it(): + glets = [] + for _ in range(ITER): + # Greenlet starts, switches back to us. + # We keep a strong reference to the greenlet though so it doesn't + # get a GreenletExit exception. + g = greenlet.greenlet(f) + glets.append(g) + g.switch() + + return glets + + test = self + + class ThreadFunc: + uss_before = uss_after = 0 + glets = () + ITER = 2 + def __call__(self): + self.uss_before = test.get_process_uss() + + for _ in range(self.ITER): + self.glets += tuple(run_it()) + + for g in self.glets: + test.assertIn('suspended active', str(g)) + # Drop them. + if deallocate_in_thread: + self.glets = () + self.uss_after = test.get_process_uss() + + # Establish baseline + uss_before = uss_after = None + for count in range(self.UNTRACK_ATTEMPTS): + EXIT_COUNT[0] = 0 + thread_func = ThreadFunc() + t = threading.Thread(target=thread_func) + t.start() + t.join(30) + self.assertFalse(t.is_alive()) + + if uss_before is None: + uss_before = thread_func.uss_before + + uss_before = max(uss_before, thread_func.uss_before) + if deallocate_in_thread: + self.assertEqual(thread_func.glets, ()) + self.assertEqual(EXIT_COUNT[0], ITER * thread_func.ITER) + + del thread_func # Deallocate the greenlets; but this won't raise into them + del t + if not deallocate_in_thread: + self.assertEqual(EXIT_COUNT[0], 0) + if deallocate_in_thread: + self.wait_for_pending_cleanups() + + uss_after = self.get_process_uss() + # See if we achieve a non-growth state at some point. Break when we do. + if uss_after <= uss_before and count > 1: + break + + self.wait_for_pending_cleanups() + uss_after = self.get_process_uss() + self.assertLessEqual(uss_after, uss_before, "after attempts %d" % (count,)) + + @ignores_leakcheck + # Because we're just trying to track raw memory, not objects, and running + # the leakcheck makes an already slow test slower. + def test_untracked_memory_doesnt_increase_unfinished_thread_dealloc_in_thread(self): + self._check_untracked_memory_thread(deallocate_in_thread=True) + + @ignores_leakcheck + # Because the main greenlets from the background threads do not exit in a timely fashion, + # we fail the object-based leakchecks. + def test_untracked_memory_doesnt_increase_unfinished_thread_dealloc_in_main(self): + self._check_untracked_memory_thread(deallocate_in_thread=False) + +if __name__ == '__main__': + __import__('unittest').main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_stack_saved.py b/.venv/Lib/site-packages/greenlet/tests/test_stack_saved.py new file mode 100644 index 0000000..b362bf9 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_stack_saved.py @@ -0,0 +1,19 @@ +import greenlet +from . import TestCase + + +class Test(TestCase): + + def test_stack_saved(self): + main = greenlet.getcurrent() + self.assertEqual(main._stack_saved, 0) + + def func(): + main.switch(main._stack_saved) + + g = greenlet.greenlet(func) + x = g.switch() + self.assertGreater(x, 0) + self.assertGreater(g._stack_saved, 0) + g.switch() + self.assertEqual(g._stack_saved, 0) diff --git a/.venv/Lib/site-packages/greenlet/tests/test_throw.py b/.venv/Lib/site-packages/greenlet/tests/test_throw.py new file mode 100644 index 0000000..f4f9a14 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_throw.py @@ -0,0 +1,128 @@ +import sys + + +from greenlet import greenlet +from . import TestCase + +def switch(*args): + return greenlet.getcurrent().parent.switch(*args) + + +class ThrowTests(TestCase): + def test_class(self): + def f(): + try: + switch("ok") + except RuntimeError: + switch("ok") + return + switch("fail") + g = greenlet(f) + res = g.switch() + self.assertEqual(res, "ok") + res = g.throw(RuntimeError) + self.assertEqual(res, "ok") + + def test_val(self): + def f(): + try: + switch("ok") + except RuntimeError: + val = sys.exc_info()[1] + if str(val) == "ciao": + switch("ok") + return + switch("fail") + + g = greenlet(f) + res = g.switch() + self.assertEqual(res, "ok") + res = g.throw(RuntimeError("ciao")) + self.assertEqual(res, "ok") + + g = greenlet(f) + res = g.switch() + self.assertEqual(res, "ok") + res = g.throw(RuntimeError, "ciao") + self.assertEqual(res, "ok") + + def test_kill(self): + def f(): + switch("ok") + switch("fail") + g = greenlet(f) + res = g.switch() + self.assertEqual(res, "ok") + res = g.throw() + self.assertTrue(isinstance(res, greenlet.GreenletExit)) + self.assertTrue(g.dead) + res = g.throw() # immediately eaten by the already-dead greenlet + self.assertTrue(isinstance(res, greenlet.GreenletExit)) + + def test_throw_goes_to_original_parent(self): + main = greenlet.getcurrent() + + def f1(): + try: + main.switch("f1 ready to catch") + except IndexError: + return "caught" + return "normal exit" + + def f2(): + main.switch("from f2") + + g1 = greenlet(f1) + g2 = greenlet(f2, parent=g1) + with self.assertRaises(IndexError): + g2.throw(IndexError) + self.assertTrue(g2.dead) + self.assertTrue(g1.dead) + + g1 = greenlet(f1) + g2 = greenlet(f2, parent=g1) + res = g1.switch() + self.assertEqual(res, "f1 ready to catch") + res = g2.throw(IndexError) + self.assertEqual(res, "caught") + self.assertTrue(g2.dead) + self.assertTrue(g1.dead) + + g1 = greenlet(f1) + g2 = greenlet(f2, parent=g1) + res = g1.switch() + self.assertEqual(res, "f1 ready to catch") + res = g2.switch() + self.assertEqual(res, "from f2") + res = g2.throw(IndexError) + self.assertEqual(res, "caught") + self.assertTrue(g2.dead) + self.assertTrue(g1.dead) + + def test_non_traceback_param(self): + with self.assertRaises(TypeError) as exc: + greenlet.getcurrent().throw( + Exception, + Exception(), + self + ) + self.assertEqual(str(exc.exception), + "throw() third argument must be a traceback object") + + def test_instance_of_wrong_type(self): + with self.assertRaises(TypeError) as exc: + greenlet.getcurrent().throw( + Exception(), + BaseException() + ) + + self.assertEqual(str(exc.exception), + "instance exception may not have a separate value") + + def test_not_throwable(self): + with self.assertRaises(TypeError) as exc: + greenlet.getcurrent().throw( + "abc" + ) + self.assertEqual(str(exc.exception), + "exceptions must be classes, or instances, not str") diff --git a/.venv/Lib/site-packages/greenlet/tests/test_tracing.py b/.venv/Lib/site-packages/greenlet/tests/test_tracing.py new file mode 100644 index 0000000..c044d4b --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_tracing.py @@ -0,0 +1,291 @@ +from __future__ import print_function +import sys +import greenlet +import unittest + +from . import TestCase +from . import PY312 + +# https://discuss.python.org/t/cpython-3-12-greenlet-and-tracing-profiling-how-to-not-crash-and-get-correct-results/33144/2 +DEBUG_BUILD_PY312 = ( + PY312 and hasattr(sys, 'gettotalrefcount'), + "Broken on debug builds of Python 3.12" +) + +class SomeError(Exception): + pass + +class GreenletTracer(object): + oldtrace = None + + def __init__(self, error_on_trace=False): + self.actions = [] + self.error_on_trace = error_on_trace + + def __call__(self, *args): + self.actions.append(args) + if self.error_on_trace: + raise SomeError + + def __enter__(self): + self.oldtrace = greenlet.settrace(self) + return self.actions + + def __exit__(self, *args): + greenlet.settrace(self.oldtrace) + + +class TestGreenletTracing(TestCase): + """ + Tests of ``greenlet.settrace()`` + """ + + def test_a_greenlet_tracing(self): + main = greenlet.getcurrent() + def dummy(): + pass + def dummyexc(): + raise SomeError() + + with GreenletTracer() as actions: + g1 = greenlet.greenlet(dummy) + g1.switch() + g2 = greenlet.greenlet(dummyexc) + self.assertRaises(SomeError, g2.switch) + + self.assertEqual(actions, [ + ('switch', (main, g1)), + ('switch', (g1, main)), + ('switch', (main, g2)), + ('throw', (g2, main)), + ]) + + def test_b_exception_disables_tracing(self): + main = greenlet.getcurrent() + def dummy(): + main.switch() + g = greenlet.greenlet(dummy) + g.switch() + with GreenletTracer(error_on_trace=True) as actions: + self.assertRaises(SomeError, g.switch) + self.assertEqual(greenlet.gettrace(), None) + + self.assertEqual(actions, [ + ('switch', (main, g)), + ]) + + def test_set_same_tracer_twice(self): + # https://github.com/python-greenlet/greenlet/issues/332 + # Our logic in asserting that the tracefunction should + # gain a reference was incorrect if the same tracefunction was set + # twice. + tracer = GreenletTracer() + with tracer: + greenlet.settrace(tracer) + + +class PythonTracer(object): + oldtrace = None + + def __init__(self): + self.actions = [] + + def __call__(self, frame, event, arg): + # Record the co_name so we have an idea what function we're in. + self.actions.append((event, frame.f_code.co_name)) + + def __enter__(self): + self.oldtrace = sys.setprofile(self) + return self.actions + + def __exit__(self, *args): + sys.setprofile(self.oldtrace) + +def tpt_callback(): + return 42 + +class TestPythonTracing(TestCase): + """ + Tests of the interaction of ``sys.settrace()`` + with greenlet facilities. + + NOTE: Most of this is probably CPython specific. + """ + + maxDiff = None + + def test_trace_events_trivial(self): + with PythonTracer() as actions: + tpt_callback() + # If we use the sys.settrace instead of setprofile, we get + # this: + + # self.assertEqual(actions, [ + # ('call', 'tpt_callback'), + # ('call', '__exit__'), + # ]) + + self.assertEqual(actions, [ + ('return', '__enter__'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('call', '__exit__'), + ('c_call', '__exit__'), + ]) + + def _trace_switch(self, glet): + with PythonTracer() as actions: + glet.switch() + return actions + + def _check_trace_events_func_already_set(self, glet): + actions = self._trace_switch(glet) + self.assertEqual(actions, [ + ('return', '__enter__'), + ('c_call', '_trace_switch'), + ('call', 'run'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('return', 'run'), + ('c_return', '_trace_switch'), + ('call', '__exit__'), + ('c_call', '__exit__'), + ]) + + def test_trace_events_into_greenlet_func_already_set(self): + def run(): + return tpt_callback() + + self._check_trace_events_func_already_set(greenlet.greenlet(run)) + + def test_trace_events_into_greenlet_subclass_already_set(self): + class X(greenlet.greenlet): + def run(self): + return tpt_callback() + self._check_trace_events_func_already_set(X()) + + def _check_trace_events_from_greenlet_sets_profiler(self, g, tracer): + g.switch() + tpt_callback() + tracer.__exit__() + self.assertEqual(tracer.actions, [ + ('return', '__enter__'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('return', 'run'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('call', '__exit__'), + ('c_call', '__exit__'), + ]) + + + def test_trace_events_from_greenlet_func_sets_profiler(self): + tracer = PythonTracer() + def run(): + tracer.__enter__() + return tpt_callback() + + self._check_trace_events_from_greenlet_sets_profiler(greenlet.greenlet(run), + tracer) + + def test_trace_events_from_greenlet_subclass_sets_profiler(self): + tracer = PythonTracer() + class X(greenlet.greenlet): + def run(self): + tracer.__enter__() + return tpt_callback() + + self._check_trace_events_from_greenlet_sets_profiler(X(), tracer) + + @unittest.skipIf(*DEBUG_BUILD_PY312) + def test_trace_events_multiple_greenlets_switching(self): + tracer = PythonTracer() + + g1 = None + g2 = None + + def g1_run(): + tracer.__enter__() + tpt_callback() + g2.switch() + tpt_callback() + return 42 + + def g2_run(): + tpt_callback() + tracer.__exit__() + tpt_callback() + g1.switch() + + g1 = greenlet.greenlet(g1_run) + g2 = greenlet.greenlet(g2_run) + + x = g1.switch() + self.assertEqual(x, 42) + tpt_callback() # ensure not in the trace + self.assertEqual(tracer.actions, [ + ('return', '__enter__'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('c_call', 'g1_run'), + ('call', 'g2_run'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('call', '__exit__'), + ('c_call', '__exit__'), + ]) + + @unittest.skipIf(*DEBUG_BUILD_PY312) + def test_trace_events_multiple_greenlets_switching_siblings(self): + # Like the first version, but get both greenlets running first + # as "siblings" and then establish the tracing. + tracer = PythonTracer() + + g1 = None + g2 = None + + def g1_run(): + greenlet.getcurrent().parent.switch() + tracer.__enter__() + tpt_callback() + g2.switch() + tpt_callback() + return 42 + + def g2_run(): + greenlet.getcurrent().parent.switch() + + tpt_callback() + tracer.__exit__() + tpt_callback() + g1.switch() + + g1 = greenlet.greenlet(g1_run) + g2 = greenlet.greenlet(g2_run) + + # Start g1 + g1.switch() + # And it immediately returns control to us. + # Start g2 + g2.switch() + # Which also returns. Now kick of the real part of the + # test. + x = g1.switch() + self.assertEqual(x, 42) + + tpt_callback() # ensure not in the trace + self.assertEqual(tracer.actions, [ + ('return', '__enter__'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('c_call', 'g1_run'), + ('call', 'tpt_callback'), + ('return', 'tpt_callback'), + ('call', '__exit__'), + ('c_call', '__exit__'), + ]) + + +if __name__ == '__main__': + unittest.main() diff --git a/.venv/Lib/site-packages/greenlet/tests/test_version.py b/.venv/Lib/site-packages/greenlet/tests/test_version.py new file mode 100644 index 0000000..96c17cf --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_version.py @@ -0,0 +1,41 @@ +#! /usr/bin/env python +from __future__ import absolute_import +from __future__ import print_function + +import sys +import os +from unittest import TestCase as NonLeakingTestCase + +import greenlet + +# No reason to run this multiple times under leakchecks, +# it doesn't do anything. +class VersionTests(NonLeakingTestCase): + def test_version(self): + def find_dominating_file(name): + if os.path.exists(name): + return name + + tried = [] + here = os.path.abspath(os.path.dirname(__file__)) + for i in range(10): + up = ['..'] * i + path = [here] + up + [name] + fname = os.path.join(*path) + fname = os.path.abspath(fname) + tried.append(fname) + if os.path.exists(fname): + return fname + raise AssertionError("Could not find file " + name + "; checked " + str(tried)) + + try: + setup_py = find_dominating_file('setup.py') + except AssertionError as e: + self.skipTest("Unable to find setup.py; must be out of tree. " + str(e)) + + + invoke_setup = "%s %s --version" % (sys.executable, setup_py) + with os.popen(invoke_setup) as f: + sversion = f.read().strip() + + self.assertEqual(sversion, greenlet.__version__) diff --git a/.venv/Lib/site-packages/greenlet/tests/test_weakref.py b/.venv/Lib/site-packages/greenlet/tests/test_weakref.py new file mode 100644 index 0000000..05a38a7 --- /dev/null +++ b/.venv/Lib/site-packages/greenlet/tests/test_weakref.py @@ -0,0 +1,35 @@ +import gc +import weakref + + +import greenlet +from . import TestCase + +class WeakRefTests(TestCase): + def test_dead_weakref(self): + def _dead_greenlet(): + g = greenlet.greenlet(lambda: None) + g.switch() + return g + o = weakref.ref(_dead_greenlet()) + gc.collect() + self.assertEqual(o(), None) + + def test_inactive_weakref(self): + o = weakref.ref(greenlet.greenlet()) + gc.collect() + self.assertEqual(o(), None) + + def test_dealloc_weakref(self): + seen = [] + def worker(): + try: + greenlet.getcurrent().parent.switch() + finally: + seen.append(g()) + g = greenlet.greenlet(worker) + g.switch() + g2 = greenlet.greenlet(lambda: None, g) + g = weakref.ref(g2) + g2 = None + self.assertEqual(seen, [None]) diff --git a/.venv/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER b/.venv/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/h11-0.14.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt b/.venv/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt new file mode 100644 index 0000000..8f080ea --- /dev/null +++ b/.venv/Lib/site-packages/h11-0.14.0.dist-info/LICENSE.txt @@ -0,0 +1,22 @@ +The MIT License (MIT) + +Copyright (c) 2016 Nathaniel J. Smith and other contributors + +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/.venv/Lib/site-packages/h11-0.14.0.dist-info/METADATA b/.venv/Lib/site-packages/h11-0.14.0.dist-info/METADATA new file mode 100644 index 0000000..cf12a82 --- /dev/null +++ b/.venv/Lib/site-packages/h11-0.14.0.dist-info/METADATA @@ -0,0 +1,193 @@ +Metadata-Version: 2.1 +Name: h11 +Version: 0.14.0 +Summary: A pure-Python, bring-your-own-I/O implementation of HTTP/1.1 +Home-page: https://github.com/python-hyper/h11 +Author: Nathaniel J. Smith +Author-email: njs@pobox.com +License: MIT +Classifier: Development Status :: 3 - Alpha +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +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: Topic :: Internet :: WWW/HTTP +Classifier: Topic :: System :: Networking +Requires-Python: >=3.7 +License-File: LICENSE.txt +Requires-Dist: typing-extensions ; python_version < "3.8" + +h11 +=== + +.. image:: https://travis-ci.org/python-hyper/h11.svg?branch=master + :target: https://travis-ci.org/python-hyper/h11 + :alt: Automated test status + +.. image:: https://codecov.io/gh/python-hyper/h11/branch/master/graph/badge.svg + :target: https://codecov.io/gh/python-hyper/h11 + :alt: Test coverage + +.. image:: https://readthedocs.org/projects/h11/badge/?version=latest + :target: http://h11.readthedocs.io/en/latest/?badge=latest + :alt: Documentation Status + +This is a little HTTP/1.1 library written from scratch in Python, +heavily inspired by `hyper-h2 `_. + +It's a "bring-your-own-I/O" library; h11 contains no IO code +whatsoever. This means you can hook h11 up to your favorite network +API, and that could be anything you want: synchronous, threaded, +asynchronous, or your own implementation of `RFC 6214 +`_ -- h11 won't judge you. +(Compare this to the current state of the art, where every time a `new +network API `_ comes along then someone +gets to start over reimplementing the entire HTTP protocol from +scratch.) Cory Benfield made an `excellent blog post describing the +benefits of this approach +`_, or if you like video +then here's his `PyCon 2016 talk on the same theme +`_. + +This also means that h11 is not immediately useful out of the box: +it's a toolkit for building programs that speak HTTP, not something +that could directly replace ``requests`` or ``twisted.web`` or +whatever. But h11 makes it much easier to implement something like +``requests`` or ``twisted.web``. + +At a high level, working with h11 goes like this: + +1) First, create an ``h11.Connection`` object to track the state of a + single HTTP/1.1 connection. + +2) When you read data off the network, pass it to + ``conn.receive_data(...)``; you'll get back a list of objects + representing high-level HTTP "events". + +3) When you want to send a high-level HTTP event, create the + corresponding "event" object and pass it to ``conn.send(...)``; + this will give you back some bytes that you can then push out + through the network. + +For example, a client might instantiate and then send a +``h11.Request`` object, then zero or more ``h11.Data`` objects for the +request body (e.g., if this is a POST), and then a +``h11.EndOfMessage`` to indicate the end of the message. Then the +server would then send back a ``h11.Response``, some ``h11.Data``, and +its own ``h11.EndOfMessage``. If either side violates the protocol, +you'll get a ``h11.ProtocolError`` exception. + +h11 is suitable for implementing both servers and clients, and has a +pleasantly symmetric API: the events you send as a client are exactly +the ones that you receive as a server and vice-versa. + +`Here's an example of a tiny HTTP client +`_ + +It also has `a fine manual `_. + +FAQ +--- + +*Whyyyyy?* + +I wanted to play with HTTP in `Curio +`__ and `Trio +`__, which at the time didn't have any +HTTP libraries. So I thought, no big deal, Python has, like, a dozen +different implementations of HTTP, surely I can find one that's +reusable. I didn't find one, but I did find Cory's call-to-arms +blog-post. So I figured, well, fine, if I have to implement HTTP from +scratch, at least I can make sure no-one *else* has to ever again. + +*Should I use it?* + +Maybe. You should be aware that it's a very young project. But, it's +feature complete and has an exhaustive test-suite and complete docs, +so the next step is for people to try using it and see how it goes +:-). If you do then please let us know -- if nothing else we'll want +to talk to you before making any incompatible changes! + +*What are the features/limitations?* + +Roughly speaking, it's trying to be a robust, complete, and non-hacky +implementation of the first "chapter" of the HTTP/1.1 spec: `RFC 7230: +HTTP/1.1 Message Syntax and Routing +`_. That is, it mostly focuses on +implementing HTTP at the level of taking bytes on and off the wire, +and the headers related to that, and tries to be anal about spec +conformance. It doesn't know about higher-level concerns like URL +routing, conditional GETs, cross-origin cookie policies, or content +negotiation. But it does know how to take care of framing, +cross-version differences in keep-alive handling, and the "obsolete +line folding" rule, so you can focus your energies on the hard / +interesting parts for your application, and it tries to support the +full specification in the sense that any useful HTTP/1.1 conformant +application should be able to use h11. + +It's pure Python, and has no dependencies outside of the standard +library. + +It has a test suite with 100.0% coverage for both statements and +branches. + +Currently it supports Python 3 (testing on 3.7-3.10) and PyPy 3. +The last Python 2-compatible version was h11 0.11.x. +(Originally it had a Cython wrapper for `http-parser +`_ and a beautiful nested state +machine implemented with ``yield from`` to postprocess the output. But +I had to take these out -- the new *parser* needs fewer lines-of-code +than the old *parser wrapper*, is written in pure Python, uses no +exotic language syntax, and has more features. It's sad, really; that +old state machine was really slick. I just need a few sentences here +to mourn that.) + +I don't know how fast it is. I haven't benchmarked or profiled it yet, +so it's probably got a few pointless hot spots, and I've been trying +to err on the side of simplicity and robustness instead of +micro-optimization. But at the architectural level I tried hard to +avoid fundamentally bad decisions, e.g., I believe that all the +parsing algorithms remain linear-time even in the face of pathological +input like slowloris, and there are no byte-by-byte loops. (I also +believe that it maintains bounded memory usage in the face of +arbitrary/pathological input.) + +The whole library is ~800 lines-of-code. You can read and understand +the whole thing in less than an hour. Most of the energy invested in +this so far has been spent on trying to keep things simple by +minimizing special-cases and ad hoc state manipulation; even though it +is now quite small and simple, I'm still annoyed that I haven't +figured out how to make it even smaller and simpler. (Unfortunately, +HTTP does not lend itself to simplicity.) + +The API is ~feature complete and I don't expect the general outlines +to change much, but you can't judge an API's ergonomics until you +actually document and use it, so I'd expect some changes in the +details. + +*How do I try it?* + +.. code-block:: sh + + $ pip install h11 + $ git clone git@github.com:python-hyper/h11 + $ cd h11/examples + $ python basic-client.py + +and go from there. + +*License?* + +MIT + +*Code of conduct?* + +Contributors are requested to follow our `code of conduct +`_ in +all project spaces. diff --git a/.venv/Lib/site-packages/h11-0.14.0.dist-info/RECORD b/.venv/Lib/site-packages/h11-0.14.0.dist-info/RECORD new file mode 100644 index 0000000..7fdd1f6 --- /dev/null +++ b/.venv/Lib/site-packages/h11-0.14.0.dist-info/RECORD @@ -0,0 +1,52 @@ +h11-0.14.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +h11-0.14.0.dist-info/LICENSE.txt,sha256=N9tbuFkm2yikJ6JYZ_ELEjIAOuob5pzLhRE4rbjm82E,1124 +h11-0.14.0.dist-info/METADATA,sha256=B7pZ0m7WBXNs17vl6hUH9bJTL9s37DaGvY31w7jNxSg,8175 +h11-0.14.0.dist-info/RECORD,, +h11-0.14.0.dist-info/WHEEL,sha256=ewwEueio1C2XeHTvT17n8dZUJgOvyCWCt0WVNLClP9o,92 +h11-0.14.0.dist-info/top_level.txt,sha256=F7dC4jl3zeh8TGHEPaWJrMbeuoWbS379Gwdi-Yvdcis,4 +h11/__init__.py,sha256=iO1KzkSO42yZ6ffg-VMgbx_ZVTWGUY00nRYEWn-s3kY,1507 +h11/__pycache__/__init__.cpython-312.pyc,, +h11/__pycache__/_abnf.cpython-312.pyc,, +h11/__pycache__/_connection.cpython-312.pyc,, +h11/__pycache__/_events.cpython-312.pyc,, +h11/__pycache__/_headers.cpython-312.pyc,, +h11/__pycache__/_readers.cpython-312.pyc,, +h11/__pycache__/_receivebuffer.cpython-312.pyc,, +h11/__pycache__/_state.cpython-312.pyc,, +h11/__pycache__/_util.cpython-312.pyc,, +h11/__pycache__/_version.cpython-312.pyc,, +h11/__pycache__/_writers.cpython-312.pyc,, +h11/_abnf.py,sha256=ybixr0xsupnkA6GFAyMubuXF6Tc1lb_hF890NgCsfNc,4815 +h11/_connection.py,sha256=eS2sorMD0zKLCFiB9lW9W9F_Nzny2tjHa4e6s1ujr1c,26539 +h11/_events.py,sha256=LEfuvg1AbhHaVRwxCd0I-pFn9-ezUOaoL8o2Kvy1PBA,11816 +h11/_headers.py,sha256=RqB8cd8CN0blYPzcLe5qeCh-phv6D1U_CHj4hs67lgQ,10230 +h11/_readers.py,sha256=EbSed0jzwVUiD1nOPAeUcVE4Flf3wXkxfb8c06-OTBM,8383 +h11/_receivebuffer.py,sha256=xrspsdsNgWFxRfQcTXxR8RrdjRXXTK0Io5cQYWpJ1Ws,5252 +h11/_state.py,sha256=k1VL6SDbaPkSrZ-49ewCXDpuiUS69_46YhbWjuV1qEY,13300 +h11/_util.py,sha256=LWkkjXyJaFlAy6Lt39w73UStklFT5ovcvo0TkY7RYuk,4888 +h11/_version.py,sha256=LVyTdiZRzIIEv79UyOgbM5iUrJUllEzlCWaJEYBY1zc,686 +h11/_writers.py,sha256=oFKm6PtjeHfbj4RLX7VB7KDc1gIY53gXG3_HR9ltmTA,5081 +h11/py.typed,sha256=sow9soTwP9T_gEAQSVh7Gb8855h04Nwmhs2We-JRgZM,7 +h11/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +h11/tests/__pycache__/__init__.cpython-312.pyc,, +h11/tests/__pycache__/helpers.cpython-312.pyc,, +h11/tests/__pycache__/test_against_stdlib_http.cpython-312.pyc,, +h11/tests/__pycache__/test_connection.cpython-312.pyc,, +h11/tests/__pycache__/test_events.cpython-312.pyc,, +h11/tests/__pycache__/test_headers.cpython-312.pyc,, +h11/tests/__pycache__/test_helpers.cpython-312.pyc,, +h11/tests/__pycache__/test_io.cpython-312.pyc,, +h11/tests/__pycache__/test_receivebuffer.cpython-312.pyc,, +h11/tests/__pycache__/test_state.cpython-312.pyc,, +h11/tests/__pycache__/test_util.cpython-312.pyc,, +h11/tests/data/test-file,sha256=ZJ03Rqs98oJw29OHzJg7LlMzyGQaRAY0r3AqBeM2wVU,65 +h11/tests/helpers.py,sha256=a1EVG_p7xU4wRsa3tMPTRxuaKCmretok9sxXWvqfmQA,3355 +h11/tests/test_against_stdlib_http.py,sha256=cojCHgHXFQ8gWhNlEEwl3trmOpN-5uDukRoHnElqo3A,3995 +h11/tests/test_connection.py,sha256=ZbPLDPclKvjgjAhgk-WlCPBaf17c4XUIV2tpaW08jOI,38720 +h11/tests/test_events.py,sha256=LPVLbcV-NvPNK9fW3rraR6Bdpz1hAlsWubMtNaJ5gHg,4657 +h11/tests/test_headers.py,sha256=qd8T1Zenuz5GbD6wklSJ5G8VS7trrYgMV0jT-SMvqg8,5612 +h11/tests/test_helpers.py,sha256=kAo0CEM4LGqmyyP2ZFmhsyq3UFJqoFfAbzu3hbWreRM,794 +h11/tests/test_io.py,sha256=uCZVnjarkRBkudfC1ij-KSCQ71XWJhnkgkgWWkKgYPQ,16386 +h11/tests/test_receivebuffer.py,sha256=3jGbeJM36Akqg_pAhPb7XzIn2NS6RhPg-Ryg8Eu6ytk,3454 +h11/tests/test_state.py,sha256=rqll9WqFsJPE0zSrtCn9LH659mPKsDeXZ-DwXwleuBQ,8928 +h11/tests/test_util.py,sha256=VO5L4nSFe4pgtSwKuv6u_6l0H7UeizF5WKuHTWreg70,2970 diff --git a/.venv/Lib/site-packages/h11-0.14.0.dist-info/WHEEL b/.venv/Lib/site-packages/h11-0.14.0.dist-info/WHEEL new file mode 100644 index 0000000..5bad85f --- /dev/null +++ b/.venv/Lib/site-packages/h11-0.14.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.37.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/.venv/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt b/.venv/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt new file mode 100644 index 0000000..0d24def --- /dev/null +++ b/.venv/Lib/site-packages/h11-0.14.0.dist-info/top_level.txt @@ -0,0 +1 @@ +h11 diff --git a/.venv/Lib/site-packages/h11/__init__.py b/.venv/Lib/site-packages/h11/__init__.py new file mode 100644 index 0000000..989e92c --- /dev/null +++ b/.venv/Lib/site-packages/h11/__init__.py @@ -0,0 +1,62 @@ +# A highish-level implementation of the HTTP/1.1 wire protocol (RFC 7230), +# containing no networking code at all, loosely modelled on hyper-h2's generic +# implementation of HTTP/2 (and in particular the h2.connection.H2Connection +# class). There's still a bunch of subtle details you need to get right if you +# want to make this actually useful, because it doesn't implement all the +# semantics to check that what you're asking to write to the wire is sensible, +# but at least it gets you out of dealing with the wire itself. + +from h11._connection import Connection, NEED_DATA, PAUSED +from h11._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from h11._state import ( + CLIENT, + CLOSED, + DONE, + ERROR, + IDLE, + MIGHT_SWITCH_PROTOCOL, + MUST_CLOSE, + SEND_BODY, + SEND_RESPONSE, + SERVER, + SWITCHED_PROTOCOL, +) +from h11._util import LocalProtocolError, ProtocolError, RemoteProtocolError +from h11._version import __version__ + +PRODUCT_ID = "python-h11/" + __version__ + + +__all__ = ( + "Connection", + "NEED_DATA", + "PAUSED", + "ConnectionClosed", + "Data", + "EndOfMessage", + "Event", + "InformationalResponse", + "Request", + "Response", + "CLIENT", + "CLOSED", + "DONE", + "ERROR", + "IDLE", + "MUST_CLOSE", + "SEND_BODY", + "SEND_RESPONSE", + "SERVER", + "SWITCHED_PROTOCOL", + "ProtocolError", + "LocalProtocolError", + "RemoteProtocolError", +) diff --git a/.venv/Lib/site-packages/h11/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..89415582b00dea1ab60c6b3fa2e609b10259a22d GIT binary patch literal 1092 zcma))&uiN-6vyrSuoEY4el<;-uG!ki-&@unc6J0x6sZX{-PRXFw*}6L+&% z1u9+u3pfXII1lo;01CJWins(yco8h(GAQFEu!Jk15}ir7%XkH>;3}x%Rj?ZQlI}gc z2G*D@p|umH3fv#c;K3|aOMmBLYjLX7ea}OK(D6N*ZtJ=RwY}aRl{$OCiP?Fg|yu84t;`c9?o`66ij?CKvXu-yD17nn!0t> zGE}NJ8+yCP{|38?g*Dnb3uKyxNfQmNsnc?+@nXLRyRRC(`abNKM$f1lO{%o|-5!jN z(R5dDYw)?Dy{2kpntHcmw7WW$y1MyNH)-MeILqud086{r^ar-vA%5r&d{-yLCse&V zEtv@WA-dzNi8KS@F(Ls=5W9nH zN0vk7Sm4NUGW2@;LSb-Cwjfp)tVhtNuOve_4j^~6BZcb)2^%VQVsf(VGN9)+Jsr#GkS3ZgqajV=#P{s9O>eQD{C)3zzu))1@AsbG z?<|`{@cn!5uj-$9g#IRz(=XO_p8Y`~^es}5fD}rgFeOBkh!9nx0*z^bi6Di3ls+Y$ zTP3fe2*LwTyGuV(Ur|CF&`jUx1fXMmqmxis3K#=@Gtx?2V1be7n~_nHLKYaQz8M^# z(|x0J3M=G+k?ET;sAPp9U~qjiUf9p^gLZ6lT(rssdu+3Kb>iBquT2)FXC6wQKK{H^ zyd@Xym7-9dwo{wp-u1bnxOWqm?ZoCoaj#So&9Xh&-d1s4k#;LJ*>I+(mKTC-(-)Wd zf}Nl0E>(2R!kXpq%l4hA<&DLVugML()I|{A;TPKX9(>@OBX;F_>kJZ196o^9@pgB2 zd*bf>`x~=_Q?sn5w2KW>)wQKf=%g&p1ctZYCh-QgYPz!24z0tFlSNB5s@Pg;8~C#p zHZ3WfL$KYO&avY`ruGfTesL;j_iKk`bA!_hiS=H%akg*0?qVH z93Hd_5C)b_C>p9DR%+G^*#td6uN2vLrTCs)+%6MA@80?N-L+Map*{Ed^^)V*(Klxb zVSklcOWTo5)rMWpeX_~MVmOByPeVbu%Ym4pA!_Rfh#&T%Aiu|0`VQ8-UDdFc>XFi8FGzP53xKguG%tCsikCQ3#7l>6SdS5b7wZ{$wf@7m7sL-uxKE<2 zDu!x`8~fzOH#Q9Y5w2LK*ffe&tYJg8bVID`Ra4x8za%%CQlqtVt0d0sVr^G^U)>T- z)xyQ5T-lMU*c5AXbF-4XrESkN_r3UHLswdLykv~QuJGC-vjTrVN>P;0p#jc~`gxR? zbQwR6GJ|f?e}_Ve5tlg`8b3t2lg!I*>V#W4x!q@ZjkuVBC}+rvJQRmQ71t&S37Yu^3peI;QLWTvHmrb%(}6Y+{D*o z$GM3kGD_c9e^9}=nUm}rZrZ15<_gI)44Fo*JlQ7f0%RJW{BA$+!%UY^_A;q-{*aqJ z=H`#cxc&3UFPFeTrF5Jr`6$lt&pA{m9SnDJaptWKhi)wV#0NgflJ-YYa@39aX_P4( zvacMo{1F-R2dhulz<@Yu#16U%pN=r2K8i58e{v&FhC2++#5ysQ%74js28d6ZGcJMH F{{vaZ_+0=1 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_connection.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_connection.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e9ed212215063d061db04094ee6cc77902cfa285 GIT binary patch literal 22619 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_readers.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_readers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5cfe0b44c8ab28af590e566a72806f413da58b6 GIT binary patch literal 9427 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 T`3j+$nX@G8o>BtM5FGelJtJ39 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_receivebuffer.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_receivebuffer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8c0b5f3b5eef5fab22021a65b5531a6b64d1fafe GIT binary patch literal 4716 zcmcH+TWk~A_0G$&$4TtOP9TAW$*YOk0Lw0`T_PS`2$WC=bb)TyO*@)+#>qH-ggcWE zM~)h;sO0QYk%*Pzel=31DiKnlYNhho|Nhv771>#;M%u6ZSq)OF{b+m6jP1M(Qa^en zpL_1P=U$(C-t*VGI+4J5b^UK6_kx6ci;ME$OUPyhkVT>rm5GzEGc#cZ)@+FxAR;~? z%&I<>yT^w)5RTUb%@t)^U|)s3C=a6W;To0E+)-9_0qy}@1iS`tFW>^;Zoq3*k0!#} z1!qK9*Ok`wnhS3Osu!p};3!jAwH7FTo6_KL*_^Ce2lPguQ%~r%g?v zR7qQctSY8rHONVA%9P`JQj-nXii}##a$+KG>f>?ECL1OC3S;qx7LOYEx6*gX3w=Yk z4KT})qN`LlhHj)IqY6#jpsAP^F^!>ddUQlfYE&^(bSR!0F@}Z#%F6gS+&^~eouOls zT5@vesy;kq=%#jbT#1Y+BbqTZdg8=!nL4H)woQL*JZ-sUSx@SwEKfJ@aEoJQ`a2+& zaR9(9dD(R6;ZL*teQ~X=J<#Gq8tP ziyuy<;uaUzlGFzj$F3DoakHAJ4*e7!z-NN8eSt48jT zU%&fH_KcG;UXx8SEO-o-lMv^;4xFD*tOF~YiP505D6|>l+`$=3=?#Tvxtc%5rP9{s&j)uFOy7g!##Q?VZkijJ#o zccF@_U4~m2ik?81HevgH6@hvuqKyOBP*tyNEzmI$4-B#%5)7c z3jvrVMK|#Uc4+czU*lR}-#Sod=4NuYSA89McgNl!t)!AQxMzEiVlk-}rYbuPPEoGs zGswlm(On}}vx@*rl>_aTtOkzBs{B|FsN{g@Df3ppt89_&g)c3@dDk=?oZ;YN>~GXB|R$XrlcEEB$a>?Xo8XTWL1;eMRfziW)q)N zCvN-)#^44nLN1F-C{xr97PPy?NA;xY%pMgJP4|KeVD3jD>#eo904$Hl`vJ=vT+$Q z0!0|O;M&~-x;`Fm65e^`txcdJ9)xG<_cZ3Kt+hbN-RCSr?9QLSwUs)oR z-yUk<{uS9EeK9et-MfbBs+_IC{?pF?RrHss=nuk&i(&oQHK1iL)rA>8!}pV)?StEd zj1a?SWYOm=Bwxx-%Q><+Zmn!0H2v^8w3_}niugYLe z%J2}d-svIH&bt800jo`FG;NOR$q{K{TryL3Y&sD<99NQKr8riSs^m1*k^&@%Z%EP@ z;>NMcm4g)1<|e*Sq}ZO&BM2~n>DvJ8ow|*GLs;8h91^#3xaGJ1&FP$}HUe?$a$?yo zj`S#Af~^a5&Erba5{&V<4j(yMQZ?@C=4i;}Bmg0yn2}L>0@*u}U9g3;czeQ7aTMT$ zeqd+l+dR{4Zwh;xWfZP4M0h8Z2$4W>?VIbHAD+LHJ)67z%-fFT_S)RFT-)>7gKL4N z?7+I$w~ghKXWq^|EU#Roq3wmgyWsC$<{yhI;*y-fA-AFBS)8& zKLwuL`g8aX;XfY!%Zb8?{?#KFF=cd@Qby1&Rt;Yya_0;6hoSI8BaoO&o&CR`@p9lI@39*r{Y+`8w8u`*V#8mx}^vYK6+@Z<_yjE}gr$)c)&%=f2+M zz%yTO-rZZUVcyrfUfVF=zR;1qvhE9JYxkxl3@bY=T>@m0cwU=M(3w?s4BX@<=^!S$ zi#<9C07vz5ZLV!T84HbcozX0 ziJn7n0l*5eO=-u6{XuPmp-)U_-ur}I4@7TQl02@sy9HgPJt z8R2lQbCbYSbRiyaaGU{Fy(}BW!myq6B z4Eluj<^4}Wh0y6u0(h}q5}KBNvaCKiwUR1yo!um`F8-Kt2`x`=y&^C<>BVcYRI@lE zZCEZdJq{_(d8_??RGS4~JW3qC%d8q~PxQEEd9K~QdTZe7z~DuSy|kl&%ZOo$E`83O zcIrH7_2Rttk#NBzS24UE3jI%k7VQS9(_i SALNPupRO3gfKwo}|KPvYhY!sF literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_state.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_state.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..11effe72d950da542b9574666e1f5557af3bc7dc GIT binary patch literal 8551 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 I5K`aqe|Wk1y#N3J literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_util.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86098cd8cdcf795982a95b37bd66c31a37c1c532 GIT binary patch literal 4736 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_version.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_version.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e20e9c629759e9ac938a11ae5c0988cae1e0f396 GIT binary patch literal 230 zcmX@j%ge<81Yi8`rmtgSV0aATzyKqZ@tFh2n9h*G5XDf*sL52tW}s(iqG#Zz$#{!9 zKE5oqs5mn}FFt-H!)K6&Um4C;F`>mk(U`={l%mYyn1IUUjKrecfTH}Y)Z~)ln1UkR z^whl6qQsK?qL`fg^x~K#AQ_)nP!OM6nr&$iqgR%iR~F-wnG{o;S(2(-keHmEn4Vf3 ylVND653^6Npz;=nO>TZlX-=wL5gX8AkaLT9fW!x8Mn=XD3Jm<>jod{nKmh=(DMG~n literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/__pycache__/_writers.cpython-312.pyc b/.venv/Lib/site-packages/h11/__pycache__/_writers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5ce64171c5e9637b85f7e189a4fe4e981db50e8 GIT binary patch literal 6302 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/_abnf.py b/.venv/Lib/site-packages/h11/_abnf.py new file mode 100644 index 0000000..933587f --- /dev/null +++ b/.venv/Lib/site-packages/h11/_abnf.py @@ -0,0 +1,132 @@ +# We use native strings for all the re patterns, to take advantage of string +# formatting, and then convert to bytestrings when compiling the final re +# objects. + +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#whitespace +# OWS = *( SP / HTAB ) +# ; optional whitespace +OWS = r"[ \t]*" + +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#rule.token.separators +# token = 1*tchar +# +# tchar = "!" / "#" / "$" / "%" / "&" / "'" / "*" +# / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~" +# / DIGIT / ALPHA +# ; any VCHAR, except delimiters +token = r"[-!#$%&'*+.^_`|~0-9a-zA-Z]+" + +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#header.fields +# field-name = token +field_name = token + +# The standard says: +# +# field-value = *( field-content / obs-fold ) +# field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ] +# field-vchar = VCHAR / obs-text +# obs-fold = CRLF 1*( SP / HTAB ) +# ; obsolete line folding +# ; see Section 3.2.4 +# +# https://tools.ietf.org/html/rfc5234#appendix-B.1 +# +# VCHAR = %x21-7E +# ; visible (printing) characters +# +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#rule.quoted-string +# obs-text = %x80-FF +# +# However, the standard definition of field-content is WRONG! It disallows +# fields containing a single visible character surrounded by whitespace, +# e.g. "foo a bar". +# +# See: https://www.rfc-editor.org/errata_search.php?rfc=7230&eid=4189 +# +# So our definition of field_content attempts to fix it up... +# +# Also, we allow lots of control characters, because apparently people assume +# that they're legal in practice (e.g., google analytics makes cookies with +# \x01 in them!): +# https://github.com/python-hyper/h11/issues/57 +# We still don't allow NUL or whitespace, because those are often treated as +# meta-characters and letting them through can lead to nasty issues like SSRF. +vchar = r"[\x21-\x7e]" +vchar_or_obs_text = r"[^\x00\s]" +field_vchar = vchar_or_obs_text +field_content = r"{field_vchar}+(?:[ \t]+{field_vchar}+)*".format(**globals()) + +# We handle obs-fold at a different level, and our fixed-up field_content +# already grows to swallow the whole value, so ? instead of * +field_value = r"({field_content})?".format(**globals()) + +# header-field = field-name ":" OWS field-value OWS +header_field = ( + r"(?P{field_name})" + r":" + r"{OWS}" + r"(?P{field_value})" + r"{OWS}".format(**globals()) +) + +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#request.line +# +# request-line = method SP request-target SP HTTP-version CRLF +# method = token +# HTTP-version = HTTP-name "/" DIGIT "." DIGIT +# HTTP-name = %x48.54.54.50 ; "HTTP", case-sensitive +# +# request-target is complicated (see RFC 7230 sec 5.3) -- could be path, full +# URL, host+port (for connect), or even "*", but in any case we are guaranteed +# that it contists of the visible printing characters. +method = token +request_target = r"{vchar}+".format(**globals()) +http_version = r"HTTP/(?P[0-9]\.[0-9])" +request_line = ( + r"(?P{method})" + r" " + r"(?P{request_target})" + r" " + r"{http_version}".format(**globals()) +) + +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#status.line +# +# status-line = HTTP-version SP status-code SP reason-phrase CRLF +# status-code = 3DIGIT +# reason-phrase = *( HTAB / SP / VCHAR / obs-text ) +status_code = r"[0-9]{3}" +reason_phrase = r"([ \t]|{vchar_or_obs_text})*".format(**globals()) +status_line = ( + r"{http_version}" + r" " + r"(?P{status_code})" + # However, there are apparently a few too many servers out there that just + # leave out the reason phrase: + # https://github.com/scrapy/scrapy/issues/345#issuecomment-281756036 + # https://github.com/seanmonstar/httparse/issues/29 + # so make it optional. ?: is a non-capturing group. + r"(?: (?P{reason_phrase}))?".format(**globals()) +) + +HEXDIG = r"[0-9A-Fa-f]" +# Actually +# +# chunk-size = 1*HEXDIG +# +# but we impose an upper-limit to avoid ridiculosity. len(str(2**64)) == 20 +chunk_size = r"({HEXDIG}){{1,20}}".format(**globals()) +# Actually +# +# chunk-ext = *( ";" chunk-ext-name [ "=" chunk-ext-val ] ) +# +# but we aren't parsing the things so we don't really care. +chunk_ext = r";.*" +chunk_header = ( + r"(?P{chunk_size})" + r"(?P{chunk_ext})?" + r"{OWS}\r\n".format( + **globals() + ) # Even though the specification does not allow for extra whitespaces, + # we are lenient with trailing whitespaces because some servers on the wild use it. +) diff --git a/.venv/Lib/site-packages/h11/_connection.py b/.venv/Lib/site-packages/h11/_connection.py new file mode 100644 index 0000000..d175270 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_connection.py @@ -0,0 +1,633 @@ +# This contains the main Connection class. Everything in h11 revolves around +# this. +from typing import Any, Callable, cast, Dict, List, Optional, Tuple, Type, Union + +from ._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from ._headers import get_comma_header, has_expect_100_continue, set_comma_header +from ._readers import READERS, ReadersType +from ._receivebuffer import ReceiveBuffer +from ._state import ( + _SWITCH_CONNECT, + _SWITCH_UPGRADE, + CLIENT, + ConnectionState, + DONE, + ERROR, + MIGHT_SWITCH_PROTOCOL, + SEND_BODY, + SERVER, + SWITCHED_PROTOCOL, +) +from ._util import ( # Import the internal things we need + LocalProtocolError, + RemoteProtocolError, + Sentinel, +) +from ._writers import WRITERS, WritersType + +# Everything in __all__ gets re-exported as part of the h11 public API. +__all__ = ["Connection", "NEED_DATA", "PAUSED"] + + +class NEED_DATA(Sentinel, metaclass=Sentinel): + pass + + +class PAUSED(Sentinel, metaclass=Sentinel): + pass + + +# If we ever have this much buffered without it making a complete parseable +# event, we error out. The only time we really buffer is when reading the +# request/response line + headers together, so this is effectively the limit on +# the size of that. +# +# Some precedents for defaults: +# - node.js: 80 * 1024 +# - tomcat: 8 * 1024 +# - IIS: 16 * 1024 +# - Apache: <8 KiB per line> +DEFAULT_MAX_INCOMPLETE_EVENT_SIZE = 16 * 1024 + +# RFC 7230's rules for connection lifecycles: +# - If either side says they want to close the connection, then the connection +# must close. +# - HTTP/1.1 defaults to keep-alive unless someone says Connection: close +# - HTTP/1.0 defaults to close unless both sides say Connection: keep-alive +# (and even this is a mess -- e.g. if you're implementing a proxy then +# sending Connection: keep-alive is forbidden). +# +# We simplify life by simply not supporting keep-alive with HTTP/1.0 peers. So +# our rule is: +# - If someone says Connection: close, we will close +# - If someone uses HTTP/1.0, we will close. +def _keep_alive(event: Union[Request, Response]) -> bool: + connection = get_comma_header(event.headers, b"connection") + if b"close" in connection: + return False + if getattr(event, "http_version", b"1.1") < b"1.1": + return False + return True + + +def _body_framing( + request_method: bytes, event: Union[Request, Response] +) -> Tuple[str, Union[Tuple[()], Tuple[int]]]: + # Called when we enter SEND_BODY to figure out framing information for + # this body. + # + # These are the only two events that can trigger a SEND_BODY state: + assert type(event) in (Request, Response) + # Returns one of: + # + # ("content-length", count) + # ("chunked", ()) + # ("http/1.0", ()) + # + # which are (lookup key, *args) for constructing body reader/writer + # objects. + # + # Reference: https://tools.ietf.org/html/rfc7230#section-3.3.3 + # + # Step 1: some responses always have an empty body, regardless of what the + # headers say. + if type(event) is Response: + if ( + event.status_code in (204, 304) + or request_method == b"HEAD" + or (request_method == b"CONNECT" and 200 <= event.status_code < 300) + ): + return ("content-length", (0,)) + # Section 3.3.3 also lists another case -- responses with status_code + # < 200. For us these are InformationalResponses, not Responses, so + # they can't get into this function in the first place. + assert event.status_code >= 200 + + # Step 2: check for Transfer-Encoding (T-E beats C-L): + transfer_encodings = get_comma_header(event.headers, b"transfer-encoding") + if transfer_encodings: + assert transfer_encodings == [b"chunked"] + return ("chunked", ()) + + # Step 3: check for Content-Length + content_lengths = get_comma_header(event.headers, b"content-length") + if content_lengths: + return ("content-length", (int(content_lengths[0]),)) + + # Step 4: no applicable headers; fallback/default depends on type + if type(event) is Request: + return ("content-length", (0,)) + else: + return ("http/1.0", ()) + + +################################################################ +# +# The main Connection class +# +################################################################ + + +class Connection: + """An object encapsulating the state of an HTTP connection. + + Args: + our_role: If you're implementing a client, pass :data:`h11.CLIENT`. If + you're implementing a server, pass :data:`h11.SERVER`. + + max_incomplete_event_size (int): + The maximum number of bytes we're willing to buffer of an + incomplete event. In practice this mostly sets a limit on the + maximum size of the request/response line + headers. If this is + exceeded, then :meth:`next_event` will raise + :exc:`RemoteProtocolError`. + + """ + + def __init__( + self, + our_role: Type[Sentinel], + max_incomplete_event_size: int = DEFAULT_MAX_INCOMPLETE_EVENT_SIZE, + ) -> None: + self._max_incomplete_event_size = max_incomplete_event_size + # State and role tracking + if our_role not in (CLIENT, SERVER): + raise ValueError("expected CLIENT or SERVER, not {!r}".format(our_role)) + self.our_role = our_role + self.their_role: Type[Sentinel] + if our_role is CLIENT: + self.their_role = SERVER + else: + self.their_role = CLIENT + self._cstate = ConnectionState() + + # Callables for converting data->events or vice-versa given the + # current state + self._writer = self._get_io_object(self.our_role, None, WRITERS) + self._reader = self._get_io_object(self.their_role, None, READERS) + + # Holds any unprocessed received data + self._receive_buffer = ReceiveBuffer() + # If this is true, then it indicates that the incoming connection was + # closed *after* the end of whatever's in self._receive_buffer: + self._receive_buffer_closed = False + + # Extra bits of state that don't fit into the state machine. + # + # These two are only used to interpret framing headers for figuring + # out how to read/write response bodies. their_http_version is also + # made available as a convenient public API. + self.their_http_version: Optional[bytes] = None + self._request_method: Optional[bytes] = None + # This is pure flow-control and doesn't at all affect the set of legal + # transitions, so no need to bother ConnectionState with it: + self.client_is_waiting_for_100_continue = False + + @property + def states(self) -> Dict[Type[Sentinel], Type[Sentinel]]: + """A dictionary like:: + + {CLIENT: , SERVER: } + + See :ref:`state-machine` for details. + + """ + return dict(self._cstate.states) + + @property + def our_state(self) -> Type[Sentinel]: + """The current state of whichever role we are playing. See + :ref:`state-machine` for details. + """ + return self._cstate.states[self.our_role] + + @property + def their_state(self) -> Type[Sentinel]: + """The current state of whichever role we are NOT playing. See + :ref:`state-machine` for details. + """ + return self._cstate.states[self.their_role] + + @property + def they_are_waiting_for_100_continue(self) -> bool: + return self.their_role is CLIENT and self.client_is_waiting_for_100_continue + + def start_next_cycle(self) -> None: + """Attempt to reset our connection state for a new request/response + cycle. + + If both client and server are in :data:`DONE` state, then resets them + both to :data:`IDLE` state in preparation for a new request/response + cycle on this same connection. Otherwise, raises a + :exc:`LocalProtocolError`. + + See :ref:`keepalive-and-pipelining`. + + """ + old_states = dict(self._cstate.states) + self._cstate.start_next_cycle() + self._request_method = None + # self.their_http_version gets left alone, since it presumably lasts + # beyond a single request/response cycle + assert not self.client_is_waiting_for_100_continue + self._respond_to_state_changes(old_states) + + def _process_error(self, role: Type[Sentinel]) -> None: + old_states = dict(self._cstate.states) + self._cstate.process_error(role) + self._respond_to_state_changes(old_states) + + def _server_switch_event(self, event: Event) -> Optional[Type[Sentinel]]: + if type(event) is InformationalResponse and event.status_code == 101: + return _SWITCH_UPGRADE + if type(event) is Response: + if ( + _SWITCH_CONNECT in self._cstate.pending_switch_proposals + and 200 <= event.status_code < 300 + ): + return _SWITCH_CONNECT + return None + + # All events go through here + def _process_event(self, role: Type[Sentinel], event: Event) -> None: + # First, pass the event through the state machine to make sure it + # succeeds. + old_states = dict(self._cstate.states) + if role is CLIENT and type(event) is Request: + if event.method == b"CONNECT": + self._cstate.process_client_switch_proposal(_SWITCH_CONNECT) + if get_comma_header(event.headers, b"upgrade"): + self._cstate.process_client_switch_proposal(_SWITCH_UPGRADE) + server_switch_event = None + if role is SERVER: + server_switch_event = self._server_switch_event(event) + self._cstate.process_event(role, type(event), server_switch_event) + + # Then perform the updates triggered by it. + + if type(event) is Request: + self._request_method = event.method + + if role is self.their_role and type(event) in ( + Request, + Response, + InformationalResponse, + ): + event = cast(Union[Request, Response, InformationalResponse], event) + self.their_http_version = event.http_version + + # Keep alive handling + # + # RFC 7230 doesn't really say what one should do if Connection: close + # shows up on a 1xx InformationalResponse. I think the idea is that + # this is not supposed to happen. In any case, if it does happen, we + # ignore it. + if type(event) in (Request, Response) and not _keep_alive( + cast(Union[Request, Response], event) + ): + self._cstate.process_keep_alive_disabled() + + # 100-continue + if type(event) is Request and has_expect_100_continue(event): + self.client_is_waiting_for_100_continue = True + if type(event) in (InformationalResponse, Response): + self.client_is_waiting_for_100_continue = False + if role is CLIENT and type(event) in (Data, EndOfMessage): + self.client_is_waiting_for_100_continue = False + + self._respond_to_state_changes(old_states, event) + + def _get_io_object( + self, + role: Type[Sentinel], + event: Optional[Event], + io_dict: Union[ReadersType, WritersType], + ) -> Optional[Callable[..., Any]]: + # event may be None; it's only used when entering SEND_BODY + state = self._cstate.states[role] + if state is SEND_BODY: + # Special case: the io_dict has a dict of reader/writer factories + # that depend on the request/response framing. + framing_type, args = _body_framing( + cast(bytes, self._request_method), cast(Union[Request, Response], event) + ) + return io_dict[SEND_BODY][framing_type](*args) # type: ignore[index] + else: + # General case: the io_dict just has the appropriate reader/writer + # for this state + return io_dict.get((role, state)) # type: ignore[return-value] + + # This must be called after any action that might have caused + # self._cstate.states to change. + def _respond_to_state_changes( + self, + old_states: Dict[Type[Sentinel], Type[Sentinel]], + event: Optional[Event] = None, + ) -> None: + # Update reader/writer + if self.our_state != old_states[self.our_role]: + self._writer = self._get_io_object(self.our_role, event, WRITERS) + if self.their_state != old_states[self.their_role]: + self._reader = self._get_io_object(self.their_role, event, READERS) + + @property + def trailing_data(self) -> Tuple[bytes, bool]: + """Data that has been received, but not yet processed, represented as + a tuple with two elements, where the first is a byte-string containing + the unprocessed data itself, and the second is a bool that is True if + the receive connection was closed. + + See :ref:`switching-protocols` for discussion of why you'd want this. + """ + return (bytes(self._receive_buffer), self._receive_buffer_closed) + + def receive_data(self, data: bytes) -> None: + """Add data to our internal receive buffer. + + This does not actually do any processing on the data, just stores + it. To trigger processing, you have to call :meth:`next_event`. + + Args: + data (:term:`bytes-like object`): + The new data that was just received. + + Special case: If *data* is an empty byte-string like ``b""``, + then this indicates that the remote side has closed the + connection (end of file). Normally this is convenient, because + standard Python APIs like :meth:`file.read` or + :meth:`socket.recv` use ``b""`` to indicate end-of-file, while + other failures to read are indicated using other mechanisms + like raising :exc:`TimeoutError`. When using such an API you + can just blindly pass through whatever you get from ``read`` + to :meth:`receive_data`, and everything will work. + + But, if you have an API where reading an empty string is a + valid non-EOF condition, then you need to be aware of this and + make sure to check for such strings and avoid passing them to + :meth:`receive_data`. + + Returns: + Nothing, but after calling this you should call :meth:`next_event` + to parse the newly received data. + + Raises: + RuntimeError: + Raised if you pass an empty *data*, indicating EOF, and then + pass a non-empty *data*, indicating more data that somehow + arrived after the EOF. + + (Calling ``receive_data(b"")`` multiple times is fine, + and equivalent to calling it once.) + + """ + if data: + if self._receive_buffer_closed: + raise RuntimeError("received close, then received more data?") + self._receive_buffer += data + else: + self._receive_buffer_closed = True + + def _extract_next_receive_event( + self, + ) -> Union[Event, Type[NEED_DATA], Type[PAUSED]]: + state = self.their_state + # We don't pause immediately when they enter DONE, because even in + # DONE state we can still process a ConnectionClosed() event. But + # if we have data in our buffer, then we definitely aren't getting + # a ConnectionClosed() immediately and we need to pause. + if state is DONE and self._receive_buffer: + return PAUSED + if state is MIGHT_SWITCH_PROTOCOL or state is SWITCHED_PROTOCOL: + return PAUSED + assert self._reader is not None + event = self._reader(self._receive_buffer) + if event is None: + if not self._receive_buffer and self._receive_buffer_closed: + # In some unusual cases (basically just HTTP/1.0 bodies), EOF + # triggers an actual protocol event; in that case, we want to + # return that event, and then the state will change and we'll + # get called again to generate the actual ConnectionClosed(). + if hasattr(self._reader, "read_eof"): + event = self._reader.read_eof() # type: ignore[attr-defined] + else: + event = ConnectionClosed() + if event is None: + event = NEED_DATA + return event # type: ignore[no-any-return] + + def next_event(self) -> Union[Event, Type[NEED_DATA], Type[PAUSED]]: + """Parse the next event out of our receive buffer, update our internal + state, and return it. + + This is a mutating operation -- think of it like calling :func:`next` + on an iterator. + + Returns: + : One of three things: + + 1) An event object -- see :ref:`events`. + + 2) The special constant :data:`NEED_DATA`, which indicates that + you need to read more data from your socket and pass it to + :meth:`receive_data` before this method will be able to return + any more events. + + 3) The special constant :data:`PAUSED`, which indicates that we + are not in a state where we can process incoming data (usually + because the peer has finished their part of the current + request/response cycle, and you have not yet called + :meth:`start_next_cycle`). See :ref:`flow-control` for details. + + Raises: + RemoteProtocolError: + The peer has misbehaved. You should close the connection + (possibly after sending some kind of 4xx response). + + Once this method returns :class:`ConnectionClosed` once, then all + subsequent calls will also return :class:`ConnectionClosed`. + + If this method raises any exception besides :exc:`RemoteProtocolError` + then that's a bug -- if it happens please file a bug report! + + If this method raises any exception then it also sets + :attr:`Connection.their_state` to :data:`ERROR` -- see + :ref:`error-handling` for discussion. + + """ + + if self.their_state is ERROR: + raise RemoteProtocolError("Can't receive data when peer state is ERROR") + try: + event = self._extract_next_receive_event() + if event not in [NEED_DATA, PAUSED]: + self._process_event(self.their_role, cast(Event, event)) + if event is NEED_DATA: + if len(self._receive_buffer) > self._max_incomplete_event_size: + # 431 is "Request header fields too large" which is pretty + # much the only situation where we can get here + raise RemoteProtocolError( + "Receive buffer too long", error_status_hint=431 + ) + if self._receive_buffer_closed: + # We're still trying to complete some event, but that's + # never going to happen because no more data is coming + raise RemoteProtocolError("peer unexpectedly closed connection") + return event + except BaseException as exc: + self._process_error(self.their_role) + if isinstance(exc, LocalProtocolError): + exc._reraise_as_remote_protocol_error() + else: + raise + + def send(self, event: Event) -> Optional[bytes]: + """Convert a high-level event into bytes that can be sent to the peer, + while updating our internal state machine. + + Args: + event: The :ref:`event ` to send. + + Returns: + If ``type(event) is ConnectionClosed``, then returns + ``None``. Otherwise, returns a :term:`bytes-like object`. + + Raises: + LocalProtocolError: + Sending this event at this time would violate our + understanding of the HTTP/1.1 protocol. + + If this method raises any exception then it also sets + :attr:`Connection.our_state` to :data:`ERROR` -- see + :ref:`error-handling` for discussion. + + """ + data_list = self.send_with_data_passthrough(event) + if data_list is None: + return None + else: + return b"".join(data_list) + + def send_with_data_passthrough(self, event: Event) -> Optional[List[bytes]]: + """Identical to :meth:`send`, except that in situations where + :meth:`send` returns a single :term:`bytes-like object`, this instead + returns a list of them -- and when sending a :class:`Data` event, this + list is guaranteed to contain the exact object you passed in as + :attr:`Data.data`. See :ref:`sendfile` for discussion. + + """ + if self.our_state is ERROR: + raise LocalProtocolError("Can't send data when our state is ERROR") + try: + if type(event) is Response: + event = self._clean_up_response_headers_for_sending(event) + # We want to call _process_event before calling the writer, + # because if someone tries to do something invalid then this will + # give a sensible error message, while our writers all just assume + # they will only receive valid events. But, _process_event might + # change self._writer. So we have to do a little dance: + writer = self._writer + self._process_event(self.our_role, event) + if type(event) is ConnectionClosed: + return None + else: + # In any situation where writer is None, process_event should + # have raised ProtocolError + assert writer is not None + data_list: List[bytes] = [] + writer(event, data_list.append) + return data_list + except: + self._process_error(self.our_role) + raise + + def send_failed(self) -> None: + """Notify the state machine that we failed to send the data it gave + us. + + This causes :attr:`Connection.our_state` to immediately become + :data:`ERROR` -- see :ref:`error-handling` for discussion. + + """ + self._process_error(self.our_role) + + # When sending a Response, we take responsibility for a few things: + # + # - Sometimes you MUST set Connection: close. We take care of those + # times. (You can also set it yourself if you want, and if you do then + # we'll respect that and close the connection at the right time. But you + # don't have to worry about that unless you want to.) + # + # - The user has to set Content-Length if they want it. Otherwise, for + # responses that have bodies (e.g. not HEAD), then we will automatically + # select the right mechanism for streaming a body of unknown length, + # which depends on depending on the peer's HTTP version. + # + # This function's *only* responsibility is making sure headers are set up + # right -- everything downstream just looks at the headers. There are no + # side channels. + def _clean_up_response_headers_for_sending(self, response: Response) -> Response: + assert type(response) is Response + + headers = response.headers + need_close = False + + # HEAD requests need some special handling: they always act like they + # have Content-Length: 0, and that's how _body_framing treats + # them. But their headers are supposed to match what we would send if + # the request was a GET. (Technically there is one deviation allowed: + # we're allowed to leave out the framing headers -- see + # https://tools.ietf.org/html/rfc7231#section-4.3.2 . But it's just as + # easy to get them right.) + method_for_choosing_headers = cast(bytes, self._request_method) + if method_for_choosing_headers == b"HEAD": + method_for_choosing_headers = b"GET" + framing_type, _ = _body_framing(method_for_choosing_headers, response) + if framing_type in ("chunked", "http/1.0"): + # This response has a body of unknown length. + # If our peer is HTTP/1.1, we use Transfer-Encoding: chunked + # If our peer is HTTP/1.0, we use no framing headers, and close the + # connection afterwards. + # + # Make sure to clear Content-Length (in principle user could have + # set both and then we ignored Content-Length b/c + # Transfer-Encoding overwrote it -- this would be naughty of them, + # but the HTTP spec says that if our peer does this then we have + # to fix it instead of erroring out, so we'll accord the user the + # same respect). + headers = set_comma_header(headers, b"content-length", []) + if self.their_http_version is None or self.their_http_version < b"1.1": + # Either we never got a valid request and are sending back an + # error (their_http_version is None), so we assume the worst; + # or else we did get a valid HTTP/1.0 request, so we know that + # they don't understand chunked encoding. + headers = set_comma_header(headers, b"transfer-encoding", []) + # This is actually redundant ATM, since currently we + # unconditionally disable keep-alive when talking to HTTP/1.0 + # peers. But let's be defensive just in case we add + # Connection: keep-alive support later: + if self._request_method != b"HEAD": + need_close = True + else: + headers = set_comma_header(headers, b"transfer-encoding", [b"chunked"]) + + if not self._cstate.keep_alive or need_close: + # Make sure Connection: close is set + connection = set(get_comma_header(headers, b"connection")) + connection.discard(b"keep-alive") + connection.add(b"close") + headers = set_comma_header(headers, b"connection", sorted(connection)) + + return Response( + headers=headers, + status_code=response.status_code, + http_version=response.http_version, + reason=response.reason, + ) diff --git a/.venv/Lib/site-packages/h11/_events.py b/.venv/Lib/site-packages/h11/_events.py new file mode 100644 index 0000000..075bf8a --- /dev/null +++ b/.venv/Lib/site-packages/h11/_events.py @@ -0,0 +1,369 @@ +# High level events that make up HTTP/1.1 conversations. Loosely inspired by +# the corresponding events in hyper-h2: +# +# http://python-hyper.org/h2/en/stable/api.html#events +# +# Don't subclass these. Stuff will break. + +import re +from abc import ABC +from dataclasses import dataclass, field +from typing import Any, cast, Dict, List, Tuple, Union + +from ._abnf import method, request_target +from ._headers import Headers, normalize_and_validate +from ._util import bytesify, LocalProtocolError, validate + +# Everything in __all__ gets re-exported as part of the h11 public API. +__all__ = [ + "Event", + "Request", + "InformationalResponse", + "Response", + "Data", + "EndOfMessage", + "ConnectionClosed", +] + +method_re = re.compile(method.encode("ascii")) +request_target_re = re.compile(request_target.encode("ascii")) + + +class Event(ABC): + """ + Base class for h11 events. + """ + + __slots__ = () + + +@dataclass(init=False, frozen=True) +class Request(Event): + """The beginning of an HTTP request. + + Fields: + + .. attribute:: method + + An HTTP method, e.g. ``b"GET"`` or ``b"POST"``. Always a byte + string. :term:`Bytes-like objects ` and native + strings containing only ascii characters will be automatically + converted to byte strings. + + .. attribute:: target + + The target of an HTTP request, e.g. ``b"/index.html"``, or one of the + more exotic formats described in `RFC 7320, section 5.3 + `_. Always a byte + string. :term:`Bytes-like objects ` and native + strings containing only ascii characters will be automatically + converted to byte strings. + + .. attribute:: headers + + Request headers, represented as a list of (name, value) pairs. See + :ref:`the header normalization rules ` for details. + + .. attribute:: http_version + + The HTTP protocol version, represented as a byte string like + ``b"1.1"``. See :ref:`the HTTP version normalization rules + ` for details. + + """ + + __slots__ = ("method", "headers", "target", "http_version") + + method: bytes + headers: Headers + target: bytes + http_version: bytes + + def __init__( + self, + *, + method: Union[bytes, str], + headers: Union[Headers, List[Tuple[bytes, bytes]], List[Tuple[str, str]]], + target: Union[bytes, str], + http_version: Union[bytes, str] = b"1.1", + _parsed: bool = False, + ) -> None: + super().__init__() + if isinstance(headers, Headers): + object.__setattr__(self, "headers", headers) + else: + object.__setattr__( + self, "headers", normalize_and_validate(headers, _parsed=_parsed) + ) + if not _parsed: + object.__setattr__(self, "method", bytesify(method)) + object.__setattr__(self, "target", bytesify(target)) + object.__setattr__(self, "http_version", bytesify(http_version)) + else: + object.__setattr__(self, "method", method) + object.__setattr__(self, "target", target) + object.__setattr__(self, "http_version", http_version) + + # "A server MUST respond with a 400 (Bad Request) status code to any + # HTTP/1.1 request message that lacks a Host header field and to any + # request message that contains more than one Host header field or a + # Host header field with an invalid field-value." + # -- https://tools.ietf.org/html/rfc7230#section-5.4 + host_count = 0 + for name, value in self.headers: + if name == b"host": + host_count += 1 + if self.http_version == b"1.1" and host_count == 0: + raise LocalProtocolError("Missing mandatory Host: header") + if host_count > 1: + raise LocalProtocolError("Found multiple Host: headers") + + validate(method_re, self.method, "Illegal method characters") + validate(request_target_re, self.target, "Illegal target characters") + + # This is an unhashable type. + __hash__ = None # type: ignore + + +@dataclass(init=False, frozen=True) +class _ResponseBase(Event): + __slots__ = ("headers", "http_version", "reason", "status_code") + + headers: Headers + http_version: bytes + reason: bytes + status_code: int + + def __init__( + self, + *, + headers: Union[Headers, List[Tuple[bytes, bytes]], List[Tuple[str, str]]], + status_code: int, + http_version: Union[bytes, str] = b"1.1", + reason: Union[bytes, str] = b"", + _parsed: bool = False, + ) -> None: + super().__init__() + if isinstance(headers, Headers): + object.__setattr__(self, "headers", headers) + else: + object.__setattr__( + self, "headers", normalize_and_validate(headers, _parsed=_parsed) + ) + if not _parsed: + object.__setattr__(self, "reason", bytesify(reason)) + object.__setattr__(self, "http_version", bytesify(http_version)) + if not isinstance(status_code, int): + raise LocalProtocolError("status code must be integer") + # Because IntEnum objects are instances of int, but aren't + # duck-compatible (sigh), see gh-72. + object.__setattr__(self, "status_code", int(status_code)) + else: + object.__setattr__(self, "reason", reason) + object.__setattr__(self, "http_version", http_version) + object.__setattr__(self, "status_code", status_code) + + self.__post_init__() + + def __post_init__(self) -> None: + pass + + # This is an unhashable type. + __hash__ = None # type: ignore + + +@dataclass(init=False, frozen=True) +class InformationalResponse(_ResponseBase): + """An HTTP informational response. + + Fields: + + .. attribute:: status_code + + The status code of this response, as an integer. For an + :class:`InformationalResponse`, this is always in the range [100, + 200). + + .. attribute:: headers + + Request headers, represented as a list of (name, value) pairs. See + :ref:`the header normalization rules ` for + details. + + .. attribute:: http_version + + The HTTP protocol version, represented as a byte string like + ``b"1.1"``. See :ref:`the HTTP version normalization rules + ` for details. + + .. attribute:: reason + + The reason phrase of this response, as a byte string. For example: + ``b"OK"``, or ``b"Not Found"``. + + """ + + def __post_init__(self) -> None: + if not (100 <= self.status_code < 200): + raise LocalProtocolError( + "InformationalResponse status_code should be in range " + "[100, 200), not {}".format(self.status_code) + ) + + # This is an unhashable type. + __hash__ = None # type: ignore + + +@dataclass(init=False, frozen=True) +class Response(_ResponseBase): + """The beginning of an HTTP response. + + Fields: + + .. attribute:: status_code + + The status code of this response, as an integer. For an + :class:`Response`, this is always in the range [200, + 1000). + + .. attribute:: headers + + Request headers, represented as a list of (name, value) pairs. See + :ref:`the header normalization rules ` for details. + + .. attribute:: http_version + + The HTTP protocol version, represented as a byte string like + ``b"1.1"``. See :ref:`the HTTP version normalization rules + ` for details. + + .. attribute:: reason + + The reason phrase of this response, as a byte string. For example: + ``b"OK"``, or ``b"Not Found"``. + + """ + + def __post_init__(self) -> None: + if not (200 <= self.status_code < 1000): + raise LocalProtocolError( + "Response status_code should be in range [200, 1000), not {}".format( + self.status_code + ) + ) + + # This is an unhashable type. + __hash__ = None # type: ignore + + +@dataclass(init=False, frozen=True) +class Data(Event): + """Part of an HTTP message body. + + Fields: + + .. attribute:: data + + A :term:`bytes-like object` containing part of a message body. Or, if + using the ``combine=False`` argument to :meth:`Connection.send`, then + any object that your socket writing code knows what to do with, and for + which calling :func:`len` returns the number of bytes that will be + written -- see :ref:`sendfile` for details. + + .. attribute:: chunk_start + + A marker that indicates whether this data object is from the start of a + chunked transfer encoding chunk. This field is ignored when when a Data + event is provided to :meth:`Connection.send`: it is only valid on + events emitted from :meth:`Connection.next_event`. You probably + shouldn't use this attribute at all; see + :ref:`chunk-delimiters-are-bad` for details. + + .. attribute:: chunk_end + + A marker that indicates whether this data object is the last for a + given chunked transfer encoding chunk. This field is ignored when when + a Data event is provided to :meth:`Connection.send`: it is only valid + on events emitted from :meth:`Connection.next_event`. You probably + shouldn't use this attribute at all; see + :ref:`chunk-delimiters-are-bad` for details. + + """ + + __slots__ = ("data", "chunk_start", "chunk_end") + + data: bytes + chunk_start: bool + chunk_end: bool + + def __init__( + self, data: bytes, chunk_start: bool = False, chunk_end: bool = False + ) -> None: + object.__setattr__(self, "data", data) + object.__setattr__(self, "chunk_start", chunk_start) + object.__setattr__(self, "chunk_end", chunk_end) + + # This is an unhashable type. + __hash__ = None # type: ignore + + +# XX FIXME: "A recipient MUST ignore (or consider as an error) any fields that +# are forbidden to be sent in a trailer, since processing them as if they were +# present in the header section might bypass external security filters." +# https://svn.tools.ietf.org/svn/wg/httpbis/specs/rfc7230.html#chunked.trailer.part +# Unfortunately, the list of forbidden fields is long and vague :-/ +@dataclass(init=False, frozen=True) +class EndOfMessage(Event): + """The end of an HTTP message. + + Fields: + + .. attribute:: headers + + Default value: ``[]`` + + Any trailing headers attached to this message, represented as a list of + (name, value) pairs. See :ref:`the header normalization rules + ` for details. + + Must be empty unless ``Transfer-Encoding: chunked`` is in use. + + """ + + __slots__ = ("headers",) + + headers: Headers + + def __init__( + self, + *, + headers: Union[ + Headers, List[Tuple[bytes, bytes]], List[Tuple[str, str]], None + ] = None, + _parsed: bool = False, + ) -> None: + super().__init__() + if headers is None: + headers = Headers([]) + elif not isinstance(headers, Headers): + headers = normalize_and_validate(headers, _parsed=_parsed) + + object.__setattr__(self, "headers", headers) + + # This is an unhashable type. + __hash__ = None # type: ignore + + +@dataclass(frozen=True) +class ConnectionClosed(Event): + """This event indicates that the sender has closed their outgoing + connection. + + Note that this does not necessarily mean that they can't *receive* further + data, because TCP connections are composed to two one-way channels which + can be closed independently. See :ref:`closing` for details. + + No fields. + """ + + pass diff --git a/.venv/Lib/site-packages/h11/_headers.py b/.venv/Lib/site-packages/h11/_headers.py new file mode 100644 index 0000000..b97d020 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_headers.py @@ -0,0 +1,278 @@ +import re +from typing import AnyStr, cast, List, overload, Sequence, Tuple, TYPE_CHECKING, Union + +from ._abnf import field_name, field_value +from ._util import bytesify, LocalProtocolError, validate + +if TYPE_CHECKING: + from ._events import Request + +try: + from typing import Literal +except ImportError: + from typing_extensions import Literal # type: ignore + + +# Facts +# ----- +# +# Headers are: +# keys: case-insensitive ascii +# values: mixture of ascii and raw bytes +# +# "Historically, HTTP has allowed field content with text in the ISO-8859-1 +# charset [ISO-8859-1], supporting other charsets only through use of +# [RFC2047] encoding. In practice, most HTTP header field values use only a +# subset of the US-ASCII charset [USASCII]. Newly defined header fields SHOULD +# limit their field values to US-ASCII octets. A recipient SHOULD treat other +# octets in field content (obs-text) as opaque data." +# And it deprecates all non-ascii values +# +# Leading/trailing whitespace in header names is forbidden +# +# Values get leading/trailing whitespace stripped +# +# Content-Disposition actually needs to contain unicode semantically; to +# accomplish this it has a terrifically weird way of encoding the filename +# itself as ascii (and even this still has lots of cross-browser +# incompatibilities) +# +# Order is important: +# "a proxy MUST NOT change the order of these field values when forwarding a +# message" +# (and there are several headers where the order indicates a preference) +# +# Multiple occurences of the same header: +# "A sender MUST NOT generate multiple header fields with the same field name +# in a message unless either the entire field value for that header field is +# defined as a comma-separated list [or the header is Set-Cookie which gets a +# special exception]" - RFC 7230. (cookies are in RFC 6265) +# +# So every header aside from Set-Cookie can be merged by b", ".join if it +# occurs repeatedly. But, of course, they can't necessarily be split by +# .split(b","), because quoting. +# +# Given all this mess (case insensitive, duplicates allowed, order is +# important, ...), there doesn't appear to be any standard way to handle +# headers in Python -- they're almost like dicts, but... actually just +# aren't. For now we punt and just use a super simple representation: headers +# are a list of pairs +# +# [(name1, value1), (name2, value2), ...] +# +# where all entries are bytestrings, names are lowercase and have no +# leading/trailing whitespace, and values are bytestrings with no +# leading/trailing whitespace. Searching and updating are done via naive O(n) +# methods. +# +# Maybe a dict-of-lists would be better? + +_content_length_re = re.compile(rb"[0-9]+") +_field_name_re = re.compile(field_name.encode("ascii")) +_field_value_re = re.compile(field_value.encode("ascii")) + + +class Headers(Sequence[Tuple[bytes, bytes]]): + """ + A list-like interface that allows iterating over headers as byte-pairs + of (lowercased-name, value). + + Internally we actually store the representation as three-tuples, + including both the raw original casing, in order to preserve casing + over-the-wire, and the lowercased name, for case-insensitive comparisions. + + r = Request( + method="GET", + target="/", + headers=[("Host", "example.org"), ("Connection", "keep-alive")], + http_version="1.1", + ) + assert r.headers == [ + (b"host", b"example.org"), + (b"connection", b"keep-alive") + ] + assert r.headers.raw_items() == [ + (b"Host", b"example.org"), + (b"Connection", b"keep-alive") + ] + """ + + __slots__ = "_full_items" + + def __init__(self, full_items: List[Tuple[bytes, bytes, bytes]]) -> None: + self._full_items = full_items + + def __bool__(self) -> bool: + return bool(self._full_items) + + def __eq__(self, other: object) -> bool: + return list(self) == list(other) # type: ignore + + def __len__(self) -> int: + return len(self._full_items) + + def __repr__(self) -> str: + return "" % repr(list(self)) + + def __getitem__(self, idx: int) -> Tuple[bytes, bytes]: # type: ignore[override] + _, name, value = self._full_items[idx] + return (name, value) + + def raw_items(self) -> List[Tuple[bytes, bytes]]: + return [(raw_name, value) for raw_name, _, value in self._full_items] + + +HeaderTypes = Union[ + List[Tuple[bytes, bytes]], + List[Tuple[bytes, str]], + List[Tuple[str, bytes]], + List[Tuple[str, str]], +] + + +@overload +def normalize_and_validate(headers: Headers, _parsed: Literal[True]) -> Headers: + ... + + +@overload +def normalize_and_validate(headers: HeaderTypes, _parsed: Literal[False]) -> Headers: + ... + + +@overload +def normalize_and_validate( + headers: Union[Headers, HeaderTypes], _parsed: bool = False +) -> Headers: + ... + + +def normalize_and_validate( + headers: Union[Headers, HeaderTypes], _parsed: bool = False +) -> Headers: + new_headers = [] + seen_content_length = None + saw_transfer_encoding = False + for name, value in headers: + # For headers coming out of the parser, we can safely skip some steps, + # because it always returns bytes and has already run these regexes + # over the data: + if not _parsed: + name = bytesify(name) + value = bytesify(value) + validate(_field_name_re, name, "Illegal header name {!r}", name) + validate(_field_value_re, value, "Illegal header value {!r}", value) + assert isinstance(name, bytes) + assert isinstance(value, bytes) + + raw_name = name + name = name.lower() + if name == b"content-length": + lengths = {length.strip() for length in value.split(b",")} + if len(lengths) != 1: + raise LocalProtocolError("conflicting Content-Length headers") + value = lengths.pop() + validate(_content_length_re, value, "bad Content-Length") + if seen_content_length is None: + seen_content_length = value + new_headers.append((raw_name, name, value)) + elif seen_content_length != value: + raise LocalProtocolError("conflicting Content-Length headers") + elif name == b"transfer-encoding": + # "A server that receives a request message with a transfer coding + # it does not understand SHOULD respond with 501 (Not + # Implemented)." + # https://tools.ietf.org/html/rfc7230#section-3.3.1 + if saw_transfer_encoding: + raise LocalProtocolError( + "multiple Transfer-Encoding headers", error_status_hint=501 + ) + # "All transfer-coding names are case-insensitive" + # -- https://tools.ietf.org/html/rfc7230#section-4 + value = value.lower() + if value != b"chunked": + raise LocalProtocolError( + "Only Transfer-Encoding: chunked is supported", + error_status_hint=501, + ) + saw_transfer_encoding = True + new_headers.append((raw_name, name, value)) + else: + new_headers.append((raw_name, name, value)) + return Headers(new_headers) + + +def get_comma_header(headers: Headers, name: bytes) -> List[bytes]: + # Should only be used for headers whose value is a list of + # comma-separated, case-insensitive values. + # + # The header name `name` is expected to be lower-case bytes. + # + # Connection: meets these criteria (including cast insensitivity). + # + # Content-Length: technically is just a single value (1*DIGIT), but the + # standard makes reference to implementations that do multiple values, and + # using this doesn't hurt. Ditto, case insensitivity doesn't things either + # way. + # + # Transfer-Encoding: is more complex (allows for quoted strings), so + # splitting on , is actually wrong. For example, this is legal: + # + # Transfer-Encoding: foo; options="1,2", chunked + # + # and should be parsed as + # + # foo; options="1,2" + # chunked + # + # but this naive function will parse it as + # + # foo; options="1 + # 2" + # chunked + # + # However, this is okay because the only thing we are going to do with + # any Transfer-Encoding is reject ones that aren't just "chunked", so + # both of these will be treated the same anyway. + # + # Expect: the only legal value is the literal string + # "100-continue". Splitting on commas is harmless. Case insensitive. + # + out: List[bytes] = [] + for _, found_name, found_raw_value in headers._full_items: + if found_name == name: + found_raw_value = found_raw_value.lower() + for found_split_value in found_raw_value.split(b","): + found_split_value = found_split_value.strip() + if found_split_value: + out.append(found_split_value) + return out + + +def set_comma_header(headers: Headers, name: bytes, new_values: List[bytes]) -> Headers: + # The header name `name` is expected to be lower-case bytes. + # + # Note that when we store the header we use title casing for the header + # names, in order to match the conventional HTTP header style. + # + # Simply calling `.title()` is a blunt approach, but it's correct + # here given the cases where we're using `set_comma_header`... + # + # Connection, Content-Length, Transfer-Encoding. + new_headers: List[Tuple[bytes, bytes]] = [] + for found_raw_name, found_name, found_raw_value in headers._full_items: + if found_name != name: + new_headers.append((found_raw_name, found_raw_value)) + for new_value in new_values: + new_headers.append((name.title(), new_value)) + return normalize_and_validate(new_headers) + + +def has_expect_100_continue(request: "Request") -> bool: + # https://tools.ietf.org/html/rfc7231#section-5.1.1 + # "A server that receives a 100-continue expectation in an HTTP/1.0 request + # MUST ignore that expectation." + if request.http_version < b"1.1": + return False + expect = get_comma_header(request.headers, b"expect") + return b"100-continue" in expect diff --git a/.venv/Lib/site-packages/h11/_readers.py b/.venv/Lib/site-packages/h11/_readers.py new file mode 100644 index 0000000..08a9574 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_readers.py @@ -0,0 +1,247 @@ +# Code to read HTTP data +# +# Strategy: each reader is a callable which takes a ReceiveBuffer object, and +# either: +# 1) consumes some of it and returns an Event +# 2) raises a LocalProtocolError (for consistency -- e.g. we call validate() +# and it might raise a LocalProtocolError, so simpler just to always use +# this) +# 3) returns None, meaning "I need more data" +# +# If they have a .read_eof attribute, then this will be called if an EOF is +# received -- but this is optional. Either way, the actual ConnectionClosed +# event will be generated afterwards. +# +# READERS is a dict describing how to pick a reader. It maps states to either: +# - a reader +# - or, for body readers, a dict of per-framing reader factories + +import re +from typing import Any, Callable, Dict, Iterable, NoReturn, Optional, Tuple, Type, Union + +from ._abnf import chunk_header, header_field, request_line, status_line +from ._events import Data, EndOfMessage, InformationalResponse, Request, Response +from ._receivebuffer import ReceiveBuffer +from ._state import ( + CLIENT, + CLOSED, + DONE, + IDLE, + MUST_CLOSE, + SEND_BODY, + SEND_RESPONSE, + SERVER, +) +from ._util import LocalProtocolError, RemoteProtocolError, Sentinel, validate + +__all__ = ["READERS"] + +header_field_re = re.compile(header_field.encode("ascii")) +obs_fold_re = re.compile(rb"[ \t]+") + + +def _obsolete_line_fold(lines: Iterable[bytes]) -> Iterable[bytes]: + it = iter(lines) + last: Optional[bytes] = None + for line in it: + match = obs_fold_re.match(line) + if match: + if last is None: + raise LocalProtocolError("continuation line at start of headers") + if not isinstance(last, bytearray): + # Cast to a mutable type, avoiding copy on append to ensure O(n) time + last = bytearray(last) + last += b" " + last += line[match.end() :] + else: + if last is not None: + yield last + last = line + if last is not None: + yield last + + +def _decode_header_lines( + lines: Iterable[bytes], +) -> Iterable[Tuple[bytes, bytes]]: + for line in _obsolete_line_fold(lines): + matches = validate(header_field_re, line, "illegal header line: {!r}", line) + yield (matches["field_name"], matches["field_value"]) + + +request_line_re = re.compile(request_line.encode("ascii")) + + +def maybe_read_from_IDLE_client(buf: ReceiveBuffer) -> Optional[Request]: + lines = buf.maybe_extract_lines() + if lines is None: + if buf.is_next_line_obviously_invalid_request_line(): + raise LocalProtocolError("illegal request line") + return None + if not lines: + raise LocalProtocolError("no request line received") + matches = validate( + request_line_re, lines[0], "illegal request line: {!r}", lines[0] + ) + return Request( + headers=list(_decode_header_lines(lines[1:])), _parsed=True, **matches + ) + + +status_line_re = re.compile(status_line.encode("ascii")) + + +def maybe_read_from_SEND_RESPONSE_server( + buf: ReceiveBuffer, +) -> Union[InformationalResponse, Response, None]: + lines = buf.maybe_extract_lines() + if lines is None: + if buf.is_next_line_obviously_invalid_request_line(): + raise LocalProtocolError("illegal request line") + return None + if not lines: + raise LocalProtocolError("no response line received") + matches = validate(status_line_re, lines[0], "illegal status line: {!r}", lines[0]) + http_version = ( + b"1.1" if matches["http_version"] is None else matches["http_version"] + ) + reason = b"" if matches["reason"] is None else matches["reason"] + status_code = int(matches["status_code"]) + class_: Union[Type[InformationalResponse], Type[Response]] = ( + InformationalResponse if status_code < 200 else Response + ) + return class_( + headers=list(_decode_header_lines(lines[1:])), + _parsed=True, + status_code=status_code, + reason=reason, + http_version=http_version, + ) + + +class ContentLengthReader: + def __init__(self, length: int) -> None: + self._length = length + self._remaining = length + + def __call__(self, buf: ReceiveBuffer) -> Union[Data, EndOfMessage, None]: + if self._remaining == 0: + return EndOfMessage() + data = buf.maybe_extract_at_most(self._remaining) + if data is None: + return None + self._remaining -= len(data) + return Data(data=data) + + def read_eof(self) -> NoReturn: + raise RemoteProtocolError( + "peer closed connection without sending complete message body " + "(received {} bytes, expected {})".format( + self._length - self._remaining, self._length + ) + ) + + +chunk_header_re = re.compile(chunk_header.encode("ascii")) + + +class ChunkedReader: + def __init__(self) -> None: + self._bytes_in_chunk = 0 + # After reading a chunk, we have to throw away the trailing \r\n; if + # this is >0 then we discard that many bytes before resuming regular + # de-chunkification. + self._bytes_to_discard = 0 + self._reading_trailer = False + + def __call__(self, buf: ReceiveBuffer) -> Union[Data, EndOfMessage, None]: + if self._reading_trailer: + lines = buf.maybe_extract_lines() + if lines is None: + return None + return EndOfMessage(headers=list(_decode_header_lines(lines))) + if self._bytes_to_discard > 0: + data = buf.maybe_extract_at_most(self._bytes_to_discard) + if data is None: + return None + self._bytes_to_discard -= len(data) + if self._bytes_to_discard > 0: + return None + # else, fall through and read some more + assert self._bytes_to_discard == 0 + if self._bytes_in_chunk == 0: + # We need to refill our chunk count + chunk_header = buf.maybe_extract_next_line() + if chunk_header is None: + return None + matches = validate( + chunk_header_re, + chunk_header, + "illegal chunk header: {!r}", + chunk_header, + ) + # XX FIXME: we discard chunk extensions. Does anyone care? + self._bytes_in_chunk = int(matches["chunk_size"], base=16) + if self._bytes_in_chunk == 0: + self._reading_trailer = True + return self(buf) + chunk_start = True + else: + chunk_start = False + assert self._bytes_in_chunk > 0 + data = buf.maybe_extract_at_most(self._bytes_in_chunk) + if data is None: + return None + self._bytes_in_chunk -= len(data) + if self._bytes_in_chunk == 0: + self._bytes_to_discard = 2 + chunk_end = True + else: + chunk_end = False + return Data(data=data, chunk_start=chunk_start, chunk_end=chunk_end) + + def read_eof(self) -> NoReturn: + raise RemoteProtocolError( + "peer closed connection without sending complete message body " + "(incomplete chunked read)" + ) + + +class Http10Reader: + def __call__(self, buf: ReceiveBuffer) -> Optional[Data]: + data = buf.maybe_extract_at_most(999999999) + if data is None: + return None + return Data(data=data) + + def read_eof(self) -> EndOfMessage: + return EndOfMessage() + + +def expect_nothing(buf: ReceiveBuffer) -> None: + if buf: + raise LocalProtocolError("Got data when expecting EOF") + return None + + +ReadersType = Dict[ + Union[Type[Sentinel], Tuple[Type[Sentinel], Type[Sentinel]]], + Union[Callable[..., Any], Dict[str, Callable[..., Any]]], +] + +READERS: ReadersType = { + (CLIENT, IDLE): maybe_read_from_IDLE_client, + (SERVER, IDLE): maybe_read_from_SEND_RESPONSE_server, + (SERVER, SEND_RESPONSE): maybe_read_from_SEND_RESPONSE_server, + (CLIENT, DONE): expect_nothing, + (CLIENT, MUST_CLOSE): expect_nothing, + (CLIENT, CLOSED): expect_nothing, + (SERVER, DONE): expect_nothing, + (SERVER, MUST_CLOSE): expect_nothing, + (SERVER, CLOSED): expect_nothing, + SEND_BODY: { + "chunked": ChunkedReader, + "content-length": ContentLengthReader, + "http/1.0": Http10Reader, + }, +} diff --git a/.venv/Lib/site-packages/h11/_receivebuffer.py b/.venv/Lib/site-packages/h11/_receivebuffer.py new file mode 100644 index 0000000..e5c4e08 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_receivebuffer.py @@ -0,0 +1,153 @@ +import re +import sys +from typing import List, Optional, Union + +__all__ = ["ReceiveBuffer"] + + +# Operations we want to support: +# - find next \r\n or \r\n\r\n (\n or \n\n are also acceptable), +# or wait until there is one +# - read at-most-N bytes +# Goals: +# - on average, do this fast +# - worst case, do this in O(n) where n is the number of bytes processed +# Plan: +# - store bytearray, offset, how far we've searched for a separator token +# - use the how-far-we've-searched data to avoid rescanning +# - while doing a stream of uninterrupted processing, advance offset instead +# of constantly copying +# WARNING: +# - I haven't benchmarked or profiled any of this yet. +# +# Note that starting in Python 3.4, deleting the initial n bytes from a +# bytearray is amortized O(n), thanks to some excellent work by Antoine +# Martin: +# +# https://bugs.python.org/issue19087 +# +# This means that if we only supported 3.4+, we could get rid of the code here +# involving self._start and self.compress, because it's doing exactly the same +# thing that bytearray now does internally. +# +# BUT unfortunately, we still support 2.7, and reading short segments out of a +# long buffer MUST be O(bytes read) to avoid DoS issues, so we can't actually +# delete this code. Yet: +# +# https://pythonclock.org/ +# +# (Two things to double-check first though: make sure PyPy also has the +# optimization, and benchmark to make sure it's a win, since we do have a +# slightly clever thing where we delay calling compress() until we've +# processed a whole event, which could in theory be slightly more efficient +# than the internal bytearray support.) +blank_line_regex = re.compile(b"\n\r?\n", re.MULTILINE) + + +class ReceiveBuffer: + def __init__(self) -> None: + self._data = bytearray() + self._next_line_search = 0 + self._multiple_lines_search = 0 + + def __iadd__(self, byteslike: Union[bytes, bytearray]) -> "ReceiveBuffer": + self._data += byteslike + return self + + def __bool__(self) -> bool: + return bool(len(self)) + + def __len__(self) -> int: + return len(self._data) + + # for @property unprocessed_data + def __bytes__(self) -> bytes: + return bytes(self._data) + + def _extract(self, count: int) -> bytearray: + # extracting an initial slice of the data buffer and return it + out = self._data[:count] + del self._data[:count] + + self._next_line_search = 0 + self._multiple_lines_search = 0 + + return out + + def maybe_extract_at_most(self, count: int) -> Optional[bytearray]: + """ + Extract a fixed number of bytes from the buffer. + """ + out = self._data[:count] + if not out: + return None + + return self._extract(count) + + def maybe_extract_next_line(self) -> Optional[bytearray]: + """ + Extract the first line, if it is completed in the buffer. + """ + # Only search in buffer space that we've not already looked at. + search_start_index = max(0, self._next_line_search - 1) + partial_idx = self._data.find(b"\r\n", search_start_index) + + if partial_idx == -1: + self._next_line_search = len(self._data) + return None + + # + 2 is to compensate len(b"\r\n") + idx = partial_idx + 2 + + return self._extract(idx) + + def maybe_extract_lines(self) -> Optional[List[bytearray]]: + """ + Extract everything up to the first blank line, and return a list of lines. + """ + # Handle the case where we have an immediate empty line. + if self._data[:1] == b"\n": + self._extract(1) + return [] + + if self._data[:2] == b"\r\n": + self._extract(2) + return [] + + # Only search in buffer space that we've not already looked at. + match = blank_line_regex.search(self._data, self._multiple_lines_search) + if match is None: + self._multiple_lines_search = max(0, len(self._data) - 2) + return None + + # Truncate the buffer and return it. + idx = match.span(0)[-1] + out = self._extract(idx) + lines = out.split(b"\n") + + for line in lines: + if line.endswith(b"\r"): + del line[-1] + + assert lines[-2] == lines[-1] == b"" + + del lines[-2:] + + return lines + + # In theory we should wait until `\r\n` before starting to validate + # incoming data. However it's interesting to detect (very) invalid data + # early given they might not even contain `\r\n` at all (hence only + # timeout will get rid of them). + # This is not a 100% effective detection but more of a cheap sanity check + # allowing for early abort in some useful cases. + # This is especially interesting when peer is messing up with HTTPS and + # sent us a TLS stream where we were expecting plain HTTP given all + # versions of TLS so far start handshake with a 0x16 message type code. + def is_next_line_obviously_invalid_request_line(self) -> bool: + try: + # HTTP header line must not contain non-printable characters + # and should not start with a space + return self._data[0] < 0x21 + except IndexError: + return False diff --git a/.venv/Lib/site-packages/h11/_state.py b/.venv/Lib/site-packages/h11/_state.py new file mode 100644 index 0000000..3593430 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_state.py @@ -0,0 +1,367 @@ +################################################################ +# The core state machine +################################################################ +# +# Rule 1: everything that affects the state machine and state transitions must +# live here in this file. As much as possible goes into the table-based +# representation, but for the bits that don't quite fit, the actual code and +# state must nonetheless live here. +# +# Rule 2: this file does not know about what role we're playing; it only knows +# about HTTP request/response cycles in the abstract. This ensures that we +# don't cheat and apply different rules to local and remote parties. +# +# +# Theory of operation +# =================== +# +# Possibly the simplest way to think about this is that we actually have 5 +# different state machines here. Yes, 5. These are: +# +# 1) The client state, with its complicated automaton (see the docs) +# 2) The server state, with its complicated automaton (see the docs) +# 3) The keep-alive state, with possible states {True, False} +# 4) The SWITCH_CONNECT state, with possible states {False, True} +# 5) The SWITCH_UPGRADE state, with possible states {False, True} +# +# For (3)-(5), the first state listed is the initial state. +# +# (1)-(3) are stored explicitly in member variables. The last +# two are stored implicitly in the pending_switch_proposals set as: +# (state of 4) == (_SWITCH_CONNECT in pending_switch_proposals) +# (state of 5) == (_SWITCH_UPGRADE in pending_switch_proposals) +# +# And each of these machines has two different kinds of transitions: +# +# a) Event-triggered +# b) State-triggered +# +# Event triggered is the obvious thing that you'd think it is: some event +# happens, and if it's the right event at the right time then a transition +# happens. But there are somewhat complicated rules for which machines can +# "see" which events. (As a rule of thumb, if a machine "sees" an event, this +# means two things: the event can affect the machine, and if the machine is +# not in a state where it expects that event then it's an error.) These rules +# are: +# +# 1) The client machine sees all h11.events objects emitted by the client. +# +# 2) The server machine sees all h11.events objects emitted by the server. +# +# It also sees the client's Request event. +# +# And sometimes, server events are annotated with a _SWITCH_* event. For +# example, we can have a (Response, _SWITCH_CONNECT) event, which is +# different from a regular Response event. +# +# 3) The keep-alive machine sees the process_keep_alive_disabled() event +# (which is derived from Request/Response events), and this event +# transitions it from True -> False, or from False -> False. There's no way +# to transition back. +# +# 4&5) The _SWITCH_* machines transition from False->True when we get a +# Request that proposes the relevant type of switch (via +# process_client_switch_proposals), and they go from True->False when we +# get a Response that has no _SWITCH_* annotation. +# +# So that's event-triggered transitions. +# +# State-triggered transitions are less standard. What they do here is couple +# the machines together. The way this works is, when certain *joint* +# configurations of states are achieved, then we automatically transition to a +# new *joint* state. So, for example, if we're ever in a joint state with +# +# client: DONE +# keep-alive: False +# +# then the client state immediately transitions to: +# +# client: MUST_CLOSE +# +# This is fundamentally different from an event-based transition, because it +# doesn't matter how we arrived at the {client: DONE, keep-alive: False} state +# -- maybe the client transitioned SEND_BODY -> DONE, or keep-alive +# transitioned True -> False. Either way, once this precondition is satisfied, +# this transition is immediately triggered. +# +# What if two conflicting state-based transitions get enabled at the same +# time? In practice there's only one case where this arises (client DONE -> +# MIGHT_SWITCH_PROTOCOL versus DONE -> MUST_CLOSE), and we resolve it by +# explicitly prioritizing the DONE -> MIGHT_SWITCH_PROTOCOL transition. +# +# Implementation +# -------------- +# +# The event-triggered transitions for the server and client machines are all +# stored explicitly in a table. Ditto for the state-triggered transitions that +# involve just the server and client state. +# +# The transitions for the other machines, and the state-triggered transitions +# that involve the other machines, are written out as explicit Python code. +# +# It'd be nice if there were some cleaner way to do all this. This isn't +# *too* terrible, but I feel like it could probably be better. +# +# WARNING +# ------- +# +# The script that generates the state machine diagrams for the docs knows how +# to read out the EVENT_TRIGGERED_TRANSITIONS and STATE_TRIGGERED_TRANSITIONS +# tables. But it can't automatically read the transitions that are written +# directly in Python code. So if you touch those, you need to also update the +# script to keep it in sync! +from typing import cast, Dict, Optional, Set, Tuple, Type, Union + +from ._events import * +from ._util import LocalProtocolError, Sentinel + +# Everything in __all__ gets re-exported as part of the h11 public API. +__all__ = [ + "CLIENT", + "SERVER", + "IDLE", + "SEND_RESPONSE", + "SEND_BODY", + "DONE", + "MUST_CLOSE", + "CLOSED", + "MIGHT_SWITCH_PROTOCOL", + "SWITCHED_PROTOCOL", + "ERROR", +] + + +class CLIENT(Sentinel, metaclass=Sentinel): + pass + + +class SERVER(Sentinel, metaclass=Sentinel): + pass + + +# States +class IDLE(Sentinel, metaclass=Sentinel): + pass + + +class SEND_RESPONSE(Sentinel, metaclass=Sentinel): + pass + + +class SEND_BODY(Sentinel, metaclass=Sentinel): + pass + + +class DONE(Sentinel, metaclass=Sentinel): + pass + + +class MUST_CLOSE(Sentinel, metaclass=Sentinel): + pass + + +class CLOSED(Sentinel, metaclass=Sentinel): + pass + + +class ERROR(Sentinel, metaclass=Sentinel): + pass + + +# Switch types +class MIGHT_SWITCH_PROTOCOL(Sentinel, metaclass=Sentinel): + pass + + +class SWITCHED_PROTOCOL(Sentinel, metaclass=Sentinel): + pass + + +class _SWITCH_UPGRADE(Sentinel, metaclass=Sentinel): + pass + + +class _SWITCH_CONNECT(Sentinel, metaclass=Sentinel): + pass + + +EventTransitionType = Dict[ + Type[Sentinel], + Dict[ + Type[Sentinel], + Dict[Union[Type[Event], Tuple[Type[Event], Type[Sentinel]]], Type[Sentinel]], + ], +] + +EVENT_TRIGGERED_TRANSITIONS: EventTransitionType = { + CLIENT: { + IDLE: {Request: SEND_BODY, ConnectionClosed: CLOSED}, + SEND_BODY: {Data: SEND_BODY, EndOfMessage: DONE}, + DONE: {ConnectionClosed: CLOSED}, + MUST_CLOSE: {ConnectionClosed: CLOSED}, + CLOSED: {ConnectionClosed: CLOSED}, + MIGHT_SWITCH_PROTOCOL: {}, + SWITCHED_PROTOCOL: {}, + ERROR: {}, + }, + SERVER: { + IDLE: { + ConnectionClosed: CLOSED, + Response: SEND_BODY, + # Special case: server sees client Request events, in this form + (Request, CLIENT): SEND_RESPONSE, + }, + SEND_RESPONSE: { + InformationalResponse: SEND_RESPONSE, + Response: SEND_BODY, + (InformationalResponse, _SWITCH_UPGRADE): SWITCHED_PROTOCOL, + (Response, _SWITCH_CONNECT): SWITCHED_PROTOCOL, + }, + SEND_BODY: {Data: SEND_BODY, EndOfMessage: DONE}, + DONE: {ConnectionClosed: CLOSED}, + MUST_CLOSE: {ConnectionClosed: CLOSED}, + CLOSED: {ConnectionClosed: CLOSED}, + SWITCHED_PROTOCOL: {}, + ERROR: {}, + }, +} + +StateTransitionType = Dict[ + Tuple[Type[Sentinel], Type[Sentinel]], Dict[Type[Sentinel], Type[Sentinel]] +] + +# NB: there are also some special-case state-triggered transitions hard-coded +# into _fire_state_triggered_transitions below. +STATE_TRIGGERED_TRANSITIONS: StateTransitionType = { + # (Client state, Server state) -> new states + # Protocol negotiation + (MIGHT_SWITCH_PROTOCOL, SWITCHED_PROTOCOL): {CLIENT: SWITCHED_PROTOCOL}, + # Socket shutdown + (CLOSED, DONE): {SERVER: MUST_CLOSE}, + (CLOSED, IDLE): {SERVER: MUST_CLOSE}, + (ERROR, DONE): {SERVER: MUST_CLOSE}, + (DONE, CLOSED): {CLIENT: MUST_CLOSE}, + (IDLE, CLOSED): {CLIENT: MUST_CLOSE}, + (DONE, ERROR): {CLIENT: MUST_CLOSE}, +} + + +class ConnectionState: + def __init__(self) -> None: + # Extra bits of state that don't quite fit into the state model. + + # If this is False then it enables the automatic DONE -> MUST_CLOSE + # transition. Don't set this directly; call .keep_alive_disabled() + self.keep_alive = True + + # This is a subset of {UPGRADE, CONNECT}, containing the proposals + # made by the client for switching protocols. + self.pending_switch_proposals: Set[Type[Sentinel]] = set() + + self.states: Dict[Type[Sentinel], Type[Sentinel]] = {CLIENT: IDLE, SERVER: IDLE} + + def process_error(self, role: Type[Sentinel]) -> None: + self.states[role] = ERROR + self._fire_state_triggered_transitions() + + def process_keep_alive_disabled(self) -> None: + self.keep_alive = False + self._fire_state_triggered_transitions() + + def process_client_switch_proposal(self, switch_event: Type[Sentinel]) -> None: + self.pending_switch_proposals.add(switch_event) + self._fire_state_triggered_transitions() + + def process_event( + self, + role: Type[Sentinel], + event_type: Type[Event], + server_switch_event: Optional[Type[Sentinel]] = None, + ) -> None: + _event_type: Union[Type[Event], Tuple[Type[Event], Type[Sentinel]]] = event_type + if server_switch_event is not None: + assert role is SERVER + if server_switch_event not in self.pending_switch_proposals: + raise LocalProtocolError( + "Received server {} event without a pending proposal".format( + server_switch_event + ) + ) + _event_type = (event_type, server_switch_event) + if server_switch_event is None and _event_type is Response: + self.pending_switch_proposals = set() + self._fire_event_triggered_transitions(role, _event_type) + # Special case: the server state does get to see Request + # events. + if _event_type is Request: + assert role is CLIENT + self._fire_event_triggered_transitions(SERVER, (Request, CLIENT)) + self._fire_state_triggered_transitions() + + def _fire_event_triggered_transitions( + self, + role: Type[Sentinel], + event_type: Union[Type[Event], Tuple[Type[Event], Type[Sentinel]]], + ) -> None: + state = self.states[role] + try: + new_state = EVENT_TRIGGERED_TRANSITIONS[role][state][event_type] + except KeyError: + event_type = cast(Type[Event], event_type) + raise LocalProtocolError( + "can't handle event type {} when role={} and state={}".format( + event_type.__name__, role, self.states[role] + ) + ) from None + self.states[role] = new_state + + def _fire_state_triggered_transitions(self) -> None: + # We apply these rules repeatedly until converging on a fixed point + while True: + start_states = dict(self.states) + + # It could happen that both these special-case transitions are + # enabled at the same time: + # + # DONE -> MIGHT_SWITCH_PROTOCOL + # DONE -> MUST_CLOSE + # + # For example, this will always be true of a HTTP/1.0 client + # requesting CONNECT. If this happens, the protocol switch takes + # priority. From there the client will either go to + # SWITCHED_PROTOCOL, in which case it's none of our business when + # they close the connection, or else the server will deny the + # request, in which case the client will go back to DONE and then + # from there to MUST_CLOSE. + if self.pending_switch_proposals: + if self.states[CLIENT] is DONE: + self.states[CLIENT] = MIGHT_SWITCH_PROTOCOL + + if not self.pending_switch_proposals: + if self.states[CLIENT] is MIGHT_SWITCH_PROTOCOL: + self.states[CLIENT] = DONE + + if not self.keep_alive: + for role in (CLIENT, SERVER): + if self.states[role] is DONE: + self.states[role] = MUST_CLOSE + + # Tabular state-triggered transitions + joint_state = (self.states[CLIENT], self.states[SERVER]) + changes = STATE_TRIGGERED_TRANSITIONS.get(joint_state, {}) + self.states.update(changes) + + if self.states == start_states: + # Fixed point reached + return + + def start_next_cycle(self) -> None: + if self.states != {CLIENT: DONE, SERVER: DONE}: + raise LocalProtocolError( + "not in a reusable state. self.states={}".format(self.states) + ) + # Can't reach DONE/DONE with any of these active, but still, let's be + # sure. + assert self.keep_alive + assert not self.pending_switch_proposals + self.states = {CLIENT: IDLE, SERVER: IDLE} diff --git a/.venv/Lib/site-packages/h11/_util.py b/.venv/Lib/site-packages/h11/_util.py new file mode 100644 index 0000000..6718445 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_util.py @@ -0,0 +1,135 @@ +from typing import Any, Dict, NoReturn, Pattern, Tuple, Type, TypeVar, Union + +__all__ = [ + "ProtocolError", + "LocalProtocolError", + "RemoteProtocolError", + "validate", + "bytesify", +] + + +class ProtocolError(Exception): + """Exception indicating a violation of the HTTP/1.1 protocol. + + This as an abstract base class, with two concrete base classes: + :exc:`LocalProtocolError`, which indicates that you tried to do something + that HTTP/1.1 says is illegal, and :exc:`RemoteProtocolError`, which + indicates that the remote peer tried to do something that HTTP/1.1 says is + illegal. See :ref:`error-handling` for details. + + In addition to the normal :exc:`Exception` features, it has one attribute: + + .. attribute:: error_status_hint + + This gives a suggestion as to what status code a server might use if + this error occurred as part of a request. + + For a :exc:`RemoteProtocolError`, this is useful as a suggestion for + how you might want to respond to a misbehaving peer, if you're + implementing a server. + + For a :exc:`LocalProtocolError`, this can be taken as a suggestion for + how your peer might have responded to *you* if h11 had allowed you to + continue. + + The default is 400 Bad Request, a generic catch-all for protocol + violations. + + """ + + def __init__(self, msg: str, error_status_hint: int = 400) -> None: + if type(self) is ProtocolError: + raise TypeError("tried to directly instantiate ProtocolError") + Exception.__init__(self, msg) + self.error_status_hint = error_status_hint + + +# Strategy: there are a number of public APIs where a LocalProtocolError can +# be raised (send(), all the different event constructors, ...), and only one +# public API where RemoteProtocolError can be raised +# (receive_data()). Therefore we always raise LocalProtocolError internally, +# and then receive_data will translate this into a RemoteProtocolError. +# +# Internally: +# LocalProtocolError is the generic "ProtocolError". +# Externally: +# LocalProtocolError is for local errors and RemoteProtocolError is for +# remote errors. +class LocalProtocolError(ProtocolError): + def _reraise_as_remote_protocol_error(self) -> NoReturn: + # After catching a LocalProtocolError, use this method to re-raise it + # as a RemoteProtocolError. This method must be called from inside an + # except: block. + # + # An easy way to get an equivalent RemoteProtocolError is just to + # modify 'self' in place. + self.__class__ = RemoteProtocolError # type: ignore + # But the re-raising is somewhat non-trivial -- you might think that + # now that we've modified the in-flight exception object, that just + # doing 'raise' to re-raise it would be enough. But it turns out that + # this doesn't work, because Python tracks the exception type + # (exc_info[0]) separately from the exception object (exc_info[1]), + # and we only modified the latter. So we really do need to re-raise + # the new type explicitly. + # On py3, the traceback is part of the exception object, so our + # in-place modification preserved it and we can just re-raise: + raise self + + +class RemoteProtocolError(ProtocolError): + pass + + +def validate( + regex: Pattern[bytes], data: bytes, msg: str = "malformed data", *format_args: Any +) -> Dict[str, bytes]: + match = regex.fullmatch(data) + if not match: + if format_args: + msg = msg.format(*format_args) + raise LocalProtocolError(msg) + return match.groupdict() + + +# Sentinel values +# +# - Inherit identity-based comparison and hashing from object +# - Have a nice repr +# - Have a *bonus property*: type(sentinel) is sentinel +# +# The bonus property is useful if you want to take the return value from +# next_event() and do some sort of dispatch based on type(event). + +_T_Sentinel = TypeVar("_T_Sentinel", bound="Sentinel") + + +class Sentinel(type): + def __new__( + cls: Type[_T_Sentinel], + name: str, + bases: Tuple[type, ...], + namespace: Dict[str, Any], + **kwds: Any + ) -> _T_Sentinel: + assert bases == (Sentinel,) + v = super().__new__(cls, name, bases, namespace, **kwds) + v.__class__ = v # type: ignore + return v + + def __repr__(self) -> str: + return self.__name__ + + +# Used for methods, request targets, HTTP versions, header names, and header +# values. Accepts ascii-strings, or bytes/bytearray/memoryview/..., and always +# returns bytes. +def bytesify(s: Union[bytes, bytearray, memoryview, int, str]) -> bytes: + # Fast-path: + if type(s) is bytes: + return s + if isinstance(s, str): + s = s.encode("ascii") + if isinstance(s, int): + raise TypeError("expected bytes-like object, not int") + return bytes(s) diff --git a/.venv/Lib/site-packages/h11/_version.py b/.venv/Lib/site-packages/h11/_version.py new file mode 100644 index 0000000..4c89113 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_version.py @@ -0,0 +1,16 @@ +# This file must be kept very simple, because it is consumed from several +# places -- it is imported by h11/__init__.py, execfile'd by setup.py, etc. + +# We use a simple scheme: +# 1.0.0 -> 1.0.0+dev -> 1.1.0 -> 1.1.0+dev +# where the +dev versions are never released into the wild, they're just what +# we stick into the VCS in between releases. +# +# This is compatible with PEP 440: +# http://legacy.python.org/dev/peps/pep-0440/ +# via the use of the "local suffix" "+dev", which is disallowed on index +# servers and causes 1.0.0+dev to sort after plain 1.0.0, which is what we +# want. (Contrast with the special suffix 1.0.0.dev, which sorts *before* +# 1.0.0.) + +__version__ = "0.14.0" diff --git a/.venv/Lib/site-packages/h11/_writers.py b/.venv/Lib/site-packages/h11/_writers.py new file mode 100644 index 0000000..939cdb9 --- /dev/null +++ b/.venv/Lib/site-packages/h11/_writers.py @@ -0,0 +1,145 @@ +# Code to read HTTP data +# +# Strategy: each writer takes an event + a write-some-bytes function, which is +# calls. +# +# WRITERS is a dict describing how to pick a reader. It maps states to either: +# - a writer +# - or, for body writers, a dict of framin-dependent writer factories + +from typing import Any, Callable, Dict, List, Tuple, Type, Union + +from ._events import Data, EndOfMessage, Event, InformationalResponse, Request, Response +from ._headers import Headers +from ._state import CLIENT, IDLE, SEND_BODY, SEND_RESPONSE, SERVER +from ._util import LocalProtocolError, Sentinel + +__all__ = ["WRITERS"] + +Writer = Callable[[bytes], Any] + + +def write_headers(headers: Headers, write: Writer) -> None: + # "Since the Host field-value is critical information for handling a + # request, a user agent SHOULD generate Host as the first header field + # following the request-line." - RFC 7230 + raw_items = headers._full_items + for raw_name, name, value in raw_items: + if name == b"host": + write(b"%s: %s\r\n" % (raw_name, value)) + for raw_name, name, value in raw_items: + if name != b"host": + write(b"%s: %s\r\n" % (raw_name, value)) + write(b"\r\n") + + +def write_request(request: Request, write: Writer) -> None: + if request.http_version != b"1.1": + raise LocalProtocolError("I only send HTTP/1.1") + write(b"%s %s HTTP/1.1\r\n" % (request.method, request.target)) + write_headers(request.headers, write) + + +# Shared between InformationalResponse and Response +def write_any_response( + response: Union[InformationalResponse, Response], write: Writer +) -> None: + if response.http_version != b"1.1": + raise LocalProtocolError("I only send HTTP/1.1") + status_bytes = str(response.status_code).encode("ascii") + # We don't bother sending ascii status messages like "OK"; they're + # optional and ignored by the protocol. (But the space after the numeric + # status code is mandatory.) + # + # XX FIXME: could at least make an effort to pull out the status message + # from stdlib's http.HTTPStatus table. Or maybe just steal their enums + # (either by import or copy/paste). We already accept them as status codes + # since they're of type IntEnum < int. + write(b"HTTP/1.1 %s %s\r\n" % (status_bytes, response.reason)) + write_headers(response.headers, write) + + +class BodyWriter: + def __call__(self, event: Event, write: Writer) -> None: + if type(event) is Data: + self.send_data(event.data, write) + elif type(event) is EndOfMessage: + self.send_eom(event.headers, write) + else: # pragma: no cover + assert False + + def send_data(self, data: bytes, write: Writer) -> None: + pass + + def send_eom(self, headers: Headers, write: Writer) -> None: + pass + + +# +# These are all careful not to do anything to 'data' except call len(data) and +# write(data). This allows us to transparently pass-through funny objects, +# like placeholder objects referring to files on disk that will be sent via +# sendfile(2). +# +class ContentLengthWriter(BodyWriter): + def __init__(self, length: int) -> None: + self._length = length + + def send_data(self, data: bytes, write: Writer) -> None: + self._length -= len(data) + if self._length < 0: + raise LocalProtocolError("Too much data for declared Content-Length") + write(data) + + def send_eom(self, headers: Headers, write: Writer) -> None: + if self._length != 0: + raise LocalProtocolError("Too little data for declared Content-Length") + if headers: + raise LocalProtocolError("Content-Length and trailers don't mix") + + +class ChunkedWriter(BodyWriter): + def send_data(self, data: bytes, write: Writer) -> None: + # if we encoded 0-length data in the naive way, it would look like an + # end-of-message. + if not data: + return + write(b"%x\r\n" % len(data)) + write(data) + write(b"\r\n") + + def send_eom(self, headers: Headers, write: Writer) -> None: + write(b"0\r\n") + write_headers(headers, write) + + +class Http10Writer(BodyWriter): + def send_data(self, data: bytes, write: Writer) -> None: + write(data) + + def send_eom(self, headers: Headers, write: Writer) -> None: + if headers: + raise LocalProtocolError("can't send trailers to HTTP/1.0 client") + # no need to close the socket ourselves, that will be taken care of by + # Connection: close machinery + + +WritersType = Dict[ + Union[Tuple[Type[Sentinel], Type[Sentinel]], Type[Sentinel]], + Union[ + Dict[str, Type[BodyWriter]], + Callable[[Union[InformationalResponse, Response], Writer], None], + Callable[[Request, Writer], None], + ], +] + +WRITERS: WritersType = { + (CLIENT, IDLE): write_request, + (SERVER, IDLE): write_any_response, + (SERVER, SEND_RESPONSE): write_any_response, + SEND_BODY: { + "chunked": ChunkedWriter, + "content-length": ContentLengthWriter, + "http/1.0": Http10Writer, + }, +} diff --git a/.venv/Lib/site-packages/h11/py.typed b/.venv/Lib/site-packages/h11/py.typed new file mode 100644 index 0000000..f5642f7 --- /dev/null +++ b/.venv/Lib/site-packages/h11/py.typed @@ -0,0 +1 @@ +Marker diff --git a/.venv/Lib/site-packages/h11/tests/__init__.py b/.venv/Lib/site-packages/h11/tests/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/h11/tests/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/h11/tests/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..1500038d3a6b6f3aac61a242c16eb3ea10d39020 GIT binary patch literal 207 zcmX@j%ge<81Yi8`ri19mAOanHW&w&!XQ*V*Wb|9fP{ah}eFmxdmFH{~6Iz^FR2-9- znNpNl91~EPoRL_R8&H&=m6}{q98*xFo1U7NT9jClUlfy*pI#i31SI1V3ku?MOS3Hv zV)V*V^U7j;GLvG8GfPr+3lfvF6Vp?RV=@d4^-EHVON#a5<1_OzOXB183My}L*yQG? bl;)(`6|n-XX9VJ65aS~=BO_xGGmr%Ui3U3R literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/tests/__pycache__/helpers.cpython-312.pyc b/.venv/Lib/site-packages/h11/tests/__pycache__/helpers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..95385052c78bde9074cb7b0b427ec5575e1906d1 GIT binary patch literal 4398 zcmb^!T})fo`P}P!?Q36yZLm!-5FikUNki7IBrR#vWrgqfQ#{Ki3Pq)+|^mqEl93L`G*TFe zQCNvp9FjxfBu?QaofrBP~Bf>KZkNg*XHg_S0$$((bhA5og6W(K*bb{A-mND-J3uuFDh7S}h! z7NUfCt@BEq3xO_#Te=aU zr=WUUExnh~%BgGUy5lms#zY&wqU=%L;F1YVH@I^t3da}bu)$BLsf=oPE+x|QSi6+M z*S?~%qYlG!CZno2sncoqXe@R%e)jbEX~TKp^u$=~Y}94=s|;t-84b$@cQ&CX3~x-8 z&riL8H7zj>3Sw8WsvDtUbt*%Y1QnM^U&Pv6M%A$4x`y%=s5kJ z2UQ^U{AkSZyf85~9ydvbb1Zi8QtV=sF@!OYo>FldaM!t%j!7a7$AqmLPJ;D$q9!3C zDuV;e0l)n}0a!=VXo+#7ESjn1DKo!Q{w}duRxjHdA)QJv#}s=N5eKYh#*l8uAJPST zKFiu(0tw8FXw$1-;3(^5kPZ=TjVe{Iw`ubgO)D?nVMe2Z;ZgB*J&vhu2~7(^Ka(1|mV5oFhl4u?jZUGh{NInbsy>1{eojabEg1FFSdS;tY3mpo>4t5D;iq8$%cvM=TplTU z>Wlv1x^K<5?eEO-MbZDp<=f7!U~fU}EqVhb5Aue$xX^t!3WVO6$j7$*2Z2jy*cF-! zLUaDmj?l3u`d0bhp4^G_6~sPRQxrq6q7*=)ZyyvPgOed_lNA>Oi5kQVlR-e%e;`1z zOpW^}w>h%Nrj8-f2Bau!cnMD8)Kwg(ip*n1S<@M$2N*P}xub)0!N>5~tO-?)gMCO8 zsB}ha0RTqfgk3IF;6khN4%f0LHs`yy#r7?(ogAXe-6^$f&F_Rg4Nvnt*Uj=s!#<17 zqF?+0p(R$Y1bIo`y=4Df*Q>=O- z%Jno*R^EctuB2|2yJ|@Wt$e_lMIy?L4nY!9mm6a8%Dg%o*B~5p!)^V6bp7hzFrqHf z0X&3?HTahoAaBe?FSv(rRcJO>ip`>UHAC$sHCI*j(yHn(S5;&!lxr1F8eu(g zQ_w_#d1de!{R$>`7=zPrdP<}9qFkANQAw+jP zZnqu#ApGaZM?>3BJ--z^m*ZC4d*RkwQ@5wyo!SZwF4xw`bLKF^ML~I_=n5a%El14%xB9 zuk>WOtZNa9&JwrsC{!$t9QgscXy&1HlWH?H+Id-32-0kg49fEVPswuaEnKO@|J%;( zJuV4Zhs@0$hWLl(Z^=>P7so^W;sC!mvapJ-(by66YbMK$LB~C6M#a!Lp_c{p%$}5% zQlaXrNo;UwXv3{&guGH^G5|aT1R$$LaFY`he};ln6wp+%t`BF@YPdbs05b#?U$YvF zPTH=W2mSM)V)`Pz%kZEMai{lUCY@OP|n zB@wmseBFS&{-W3a`tWPRtMdBH+RR3<5bh~>dw0E06ueK|9pCW|ekun38_U>^_o=;5 z*T&hmhu<9Dl;4}VGjlIk=s#8Hes(+blbok023BAESZpnZI&wpMzUF+-?d~04Z!z4u z`t#gS5eSz)_H}IuU0c4cqOUP0nvQ`s%q-PW#&VF~fP$tb6daEmo_Jiz$n$B6d*ks} z<`ZdahCB(DGK4vjfksweAT+_Oig}V^G^fcU6wsPaXkwZzIia~hj!{4zaR-?@usri) zN~M7MS$h@04Ybd){PB{2ob@G^;Sa7ZZuAwJj(&px-*?#5k{>-g#C+{;^JS znp)xkFF8@TCI7?*fAi!fztwWI5b7_vC|y8-@T#02SexA#*zCRATj(3y3J(_iCreZW zbkiQ+eGxEgZ*)ha(SwE)9uX;Z+In7?2Qm+7o{yg15aYB!T8~A`6tsIX-z0|1?m6fq z#B6E^eb-nv@lz~7K?4B8NjoBV!T{hB&OuWr!Xl zBtwjVwa+*_jj*c0OVfH&SVpIfG@*TuX=w61#ST%>1;7xVww!&6jKN=e^Js4YC^;C0 z`2rpP1ReheI#EC;9JO1Mko7Q%b46jtOs!ZytK{r4j=4?)be!@4vK9(Fccn tncz1Fz`shD86-492rzwLa8bIqzHc>ZxDS!@^a=Fg3Gt`A<1ZWo@IN47upa;b literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/tests/__pycache__/test_against_stdlib_http.cpython-312.pyc b/.venv/Lib/site-packages/h11/tests/__pycache__/test_against_stdlib_http.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e797a3afcd92ec5636d01bc7b06ebd4924eb4afc GIT binary patch literal 6931 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 JFBdv&`#+T%ejNY+ literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/tests/__pycache__/test_connection.cpython-312.pyc b/.venv/Lib/site-packages/h11/tests/__pycache__/test_connection.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8b9bc24aaff085268544eba7d24be02f158bb3a6 GIT binary patch literal 58000 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 Vpy^8mZL0;jy!~+{>afk`{{>J0?)d-! literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/tests/__pycache__/test_receivebuffer.cpython-312.pyc b/.venv/Lib/site-packages/h11/tests/__pycache__/test_receivebuffer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fd20aaaa224875602d0451c6581c107630b0555f GIT binary patch literal 3990 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 CF9}ls literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/tests/__pycache__/test_util.cpython-312.pyc b/.venv/Lib/site-packages/h11/tests/__pycache__/test_util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2a83b76eb6e043a5f5bad7546739962340f8fcce GIT binary patch literal 6126 zcmcf_TTC3+_0Ef(VRjiFCXirkz&yOzCJQzOw;Q|WVJD8Wu}mKImUgwU175rjdS`g7 zyTmBU2Yy7^539zhC0mt0963^2C2CVOQfr8+O8uE-v7i$owMwPRe^zisM1Fei?9L8r zmMD)lSDJgyoH_U2Gv}Vyy?=8!3K6tNFMc}wwusPY=*p|>zBdd0BaYX?3tz`enG9RLde z76G&YlmPMoivbD%O8^!EER9i4`vW45$4TkDCwf{|$8h8UkuR5qiS?88tTP3igicsYuRZz99899BHt%R)L=vo>HN4q6b$%Pd5|n;wgNyHcvi=u zyM|QC{4ioF$s_<&S@Y#?hOZq_NVS>N0A&IbG#fUtpD*dB)->@8!v0shi{!nyS=^udJ=N}#Q zg~!eva`m^2%aQT^lfi+0C8)~#M*V~5{KK-+f3~&tX(EAQ^u94Q7-|`X-5@kyj;3)b zNJ1WE7j)BTMUdXAzF2)Vc3-Gn;mfrr_AK&y*BDe-wvkg#D_EDgU-?LsOrrdvJ2d!~>|Mj0)R%$*2O=XQfo^a=Dj6-Oi49W*%+ z7`er92KHzCSHL(kf`JZX~HMGUP#v0lJXlctSdUR$e8Vx2OFa>`N-8+^`K1dQzhmaYvQ)ez)g`66TZ0RdQ{$cYCFhq9IpAD>$eVL~xNEWK zu*M($cC%32GgmuT5rBsUB6ko(6Waf7FM0F$7b{XN2qm;HSMR*}>h)J|pIK_?Og40W zRQ9Lsf7t%V9e<^ghfbs#o=;VuobfE%i`@9IPTzz zRF>$ue15Uom6Ti>@6sgKvQ+j~>|$*8*n(82@pYP12b3kLAt^Q7DO-^CYW!YJ+Phr& z)J@xU+ihW~W`D9~{|DW_Kl$5}?|c5-nmo{(syUXbJU-)CmbRzI-HI$q?Hb>HUuysI zp$N;aD+8eQ*F^_oT)C~Q8qHM; z-G`XD#-l>_0cQSbw%d*74{$)5Kg1B+EgUOmKIXcpV^R z4=eLQp5s7Rqm5)Ufk}ZXg;=lA%;;fMDcL9=hm2=B_2xRo$_Bufb^a+TP6gNi7bv)~ zAzOZDIc#4c$9Mfle(Sk6*J4-V>00dZ8tqC?etNcc6Ff>I=z8~&Q|@6L9UE;u{1ex{ zLqFZ)>~G1^+Dw{4szFzaLL!!{rF9jy9l4CY)k*6G=?OBhO(6;ZuE|M-#6Z9bA^6Z( z)@_5)@Mth3W0J11gLK3UFe&(99xfb%u$GxdG1jc9Nyib^(UiSwx;In7Emk=13(YHhaiV;dTjY0;8g36bY|#@5dG?i*qkj6>vRHD9 z{SBKeZ(k7GHMU(7+kv65m=u5;hx3bktug#x>EbZ&H%(|>D}yBfuCEnkkbeu!&5C!?xXE zW{=-|;ra`y%I2iltg+3S*u2HC{yS}pd`o6v#f|;56E~->Po=8%CB=OjOZv5P)64nC zk+h!|b-S2*9Yx)4X6}g8!!z?P$gQ?{H`l}2KIXZel3YK}rqk0#I;GKZxYu|ClAU!7 zvM{J?Gj_Mdv2jD1i=#NQ4hNPOT8GShX?WwYlFV?H+U&>H3~^*0U<|ogkejolwXh9x zQyY%E*^7q&XGsdHQs+9rNHT}tI0Z6L>9>4;v4NJIZ!E(fgXEzOn!?Wm(@TW$edwmq zBbwqISDwAi{|Ab12Pu_{6V&C7#NegF8vEqT;bqaDpe`MpeqrX|iYSp!OJY@0teRC8 z#5#?w)5JQ$Qj%aUc22)I)0tsP_%FIOwqnNph$Zv?_;%%n`RU7@33WlN(%33ZtRlnd zOC8gmnGS-UPV`)SMq?{yp23-aS03Cn7tb@YH@4k>`lhzne!yG zj{He0Ta9w*q}AHCUuU2jBgMx*XFkA(06GgWQGzazJ5@i%{+N}U^wO6j!NF)i?u{5d zxi`S1B6-~M(*>k?D~nG7%P>6340Mo&#InS(6jPl&ieoW literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/h11/tests/data/test-file b/.venv/Lib/site-packages/h11/tests/data/test-file new file mode 100644 index 0000000..d0be0a6 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/data/test-file @@ -0,0 +1 @@ +92b12bc045050b55b848d37167a1a63947c364579889ce1d39788e45e9fac9e5 diff --git a/.venv/Lib/site-packages/h11/tests/helpers.py b/.venv/Lib/site-packages/h11/tests/helpers.py new file mode 100644 index 0000000..571be44 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/helpers.py @@ -0,0 +1,101 @@ +from typing import cast, List, Type, Union, ValuesView + +from .._connection import Connection, NEED_DATA, PAUSED +from .._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from .._state import CLIENT, CLOSED, DONE, MUST_CLOSE, SERVER +from .._util import Sentinel + +try: + from typing import Literal +except ImportError: + from typing_extensions import Literal # type: ignore + + +def get_all_events(conn: Connection) -> List[Event]: + got_events = [] + while True: + event = conn.next_event() + if event in (NEED_DATA, PAUSED): + break + event = cast(Event, event) + got_events.append(event) + if type(event) is ConnectionClosed: + break + return got_events + + +def receive_and_get(conn: Connection, data: bytes) -> List[Event]: + conn.receive_data(data) + return get_all_events(conn) + + +# Merges adjacent Data events, converts payloads to bytestrings, and removes +# chunk boundaries. +def normalize_data_events(in_events: List[Event]) -> List[Event]: + out_events: List[Event] = [] + for event in in_events: + if type(event) is Data: + event = Data(data=bytes(event.data), chunk_start=False, chunk_end=False) + if out_events and type(out_events[-1]) is type(event) is Data: + out_events[-1] = Data( + data=out_events[-1].data + event.data, + chunk_start=out_events[-1].chunk_start, + chunk_end=out_events[-1].chunk_end, + ) + else: + out_events.append(event) + return out_events + + +# Given that we want to write tests that push some events through a Connection +# and check that its state updates appropriately... we might as make a habit +# of pushing them through two Connections with a fake network link in +# between. +class ConnectionPair: + def __init__(self) -> None: + self.conn = {CLIENT: Connection(CLIENT), SERVER: Connection(SERVER)} + self.other = {CLIENT: SERVER, SERVER: CLIENT} + + @property + def conns(self) -> ValuesView[Connection]: + return self.conn.values() + + # expect="match" if expect=send_events; expect=[...] to say what expected + def send( + self, + role: Type[Sentinel], + send_events: Union[List[Event], Event], + expect: Union[List[Event], Event, Literal["match"]] = "match", + ) -> bytes: + if not isinstance(send_events, list): + send_events = [send_events] + data = b"" + closed = False + for send_event in send_events: + new_data = self.conn[role].send(send_event) + if new_data is None: + closed = True + else: + data += new_data + # send uses b"" to mean b"", and None to mean closed + # receive uses b"" to mean closed, and None to mean "try again" + # so we have to translate between the two conventions + if data: + self.conn[self.other[role]].receive_data(data) + if closed: + self.conn[self.other[role]].receive_data(b"") + got_events = get_all_events(self.conn[self.other[role]]) + if expect == "match": + expect = send_events + if not isinstance(expect, list): + expect = [expect] + assert got_events == expect + return data diff --git a/.venv/Lib/site-packages/h11/tests/test_against_stdlib_http.py b/.venv/Lib/site-packages/h11/tests/test_against_stdlib_http.py new file mode 100644 index 0000000..d2ee131 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_against_stdlib_http.py @@ -0,0 +1,115 @@ +import json +import os.path +import socket +import socketserver +import threading +from contextlib import closing, contextmanager +from http.server import SimpleHTTPRequestHandler +from typing import Callable, Generator +from urllib.request import urlopen + +import h11 + + +@contextmanager +def socket_server( + handler: Callable[..., socketserver.BaseRequestHandler] +) -> Generator[socketserver.TCPServer, None, None]: + httpd = socketserver.TCPServer(("127.0.0.1", 0), handler) + thread = threading.Thread( + target=httpd.serve_forever, kwargs={"poll_interval": 0.01} + ) + thread.daemon = True + try: + thread.start() + yield httpd + finally: + httpd.shutdown() + + +test_file_path = os.path.join(os.path.dirname(__file__), "data/test-file") +with open(test_file_path, "rb") as f: + test_file_data = f.read() + + +class SingleMindedRequestHandler(SimpleHTTPRequestHandler): + def translate_path(self, path: str) -> str: + return test_file_path + + +def test_h11_as_client() -> None: + with socket_server(SingleMindedRequestHandler) as httpd: + with closing(socket.create_connection(httpd.server_address)) as s: + c = h11.Connection(h11.CLIENT) + + s.sendall( + c.send( # type: ignore[arg-type] + h11.Request( + method="GET", target="/foo", headers=[("Host", "localhost")] + ) + ) + ) + s.sendall(c.send(h11.EndOfMessage())) # type: ignore[arg-type] + + data = bytearray() + while True: + event = c.next_event() + print(event) + if event is h11.NEED_DATA: + # Use a small read buffer to make things more challenging + # and exercise more paths :-) + c.receive_data(s.recv(10)) + continue + if type(event) is h11.Response: + assert event.status_code == 200 + if type(event) is h11.Data: + data += event.data + if type(event) is h11.EndOfMessage: + break + assert bytes(data) == test_file_data + + +class H11RequestHandler(socketserver.BaseRequestHandler): + def handle(self) -> None: + with closing(self.request) as s: + c = h11.Connection(h11.SERVER) + request = None + while True: + event = c.next_event() + if event is h11.NEED_DATA: + # Use a small read buffer to make things more challenging + # and exercise more paths :-) + c.receive_data(s.recv(10)) + continue + if type(event) is h11.Request: + request = event + if type(event) is h11.EndOfMessage: + break + assert request is not None + info = json.dumps( + { + "method": request.method.decode("ascii"), + "target": request.target.decode("ascii"), + "headers": { + name.decode("ascii"): value.decode("ascii") + for (name, value) in request.headers + }, + } + ) + s.sendall(c.send(h11.Response(status_code=200, headers=[]))) # type: ignore[arg-type] + s.sendall(c.send(h11.Data(data=info.encode("ascii")))) + s.sendall(c.send(h11.EndOfMessage())) + + +def test_h11_as_server() -> None: + with socket_server(H11RequestHandler) as httpd: + host, port = httpd.server_address + url = "http://{}:{}/some-path".format(host, port) + with closing(urlopen(url)) as f: + assert f.getcode() == 200 + data = f.read() + info = json.loads(data.decode("ascii")) + print(info) + assert info["method"] == "GET" + assert info["target"] == "/some-path" + assert "urllib" in info["headers"]["user-agent"] diff --git a/.venv/Lib/site-packages/h11/tests/test_connection.py b/.venv/Lib/site-packages/h11/tests/test_connection.py new file mode 100644 index 0000000..73a27b9 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_connection.py @@ -0,0 +1,1122 @@ +from typing import Any, cast, Dict, List, Optional, Tuple, Type + +import pytest + +from .._connection import _body_framing, _keep_alive, Connection, NEED_DATA, PAUSED +from .._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from .._state import ( + CLIENT, + CLOSED, + DONE, + ERROR, + IDLE, + MIGHT_SWITCH_PROTOCOL, + MUST_CLOSE, + SEND_BODY, + SEND_RESPONSE, + SERVER, + SWITCHED_PROTOCOL, +) +from .._util import LocalProtocolError, RemoteProtocolError, Sentinel +from .helpers import ConnectionPair, get_all_events, receive_and_get + + +def test__keep_alive() -> None: + assert _keep_alive( + Request(method="GET", target="/", headers=[("Host", "Example.com")]) + ) + assert not _keep_alive( + Request( + method="GET", + target="/", + headers=[("Host", "Example.com"), ("Connection", "close")], + ) + ) + assert not _keep_alive( + Request( + method="GET", + target="/", + headers=[("Host", "Example.com"), ("Connection", "a, b, cLOse, foo")], + ) + ) + assert not _keep_alive( + Request(method="GET", target="/", headers=[], http_version="1.0") # type: ignore[arg-type] + ) + + assert _keep_alive(Response(status_code=200, headers=[])) # type: ignore[arg-type] + assert not _keep_alive(Response(status_code=200, headers=[("Connection", "close")])) + assert not _keep_alive( + Response(status_code=200, headers=[("Connection", "a, b, cLOse, foo")]) + ) + assert not _keep_alive(Response(status_code=200, headers=[], http_version="1.0")) # type: ignore[arg-type] + + +def test__body_framing() -> None: + def headers(cl: Optional[int], te: bool) -> List[Tuple[str, str]]: + headers = [] + if cl is not None: + headers.append(("Content-Length", str(cl))) + if te: + headers.append(("Transfer-Encoding", "chunked")) + return headers + + def resp( + status_code: int = 200, cl: Optional[int] = None, te: bool = False + ) -> Response: + return Response(status_code=status_code, headers=headers(cl, te)) + + def req(cl: Optional[int] = None, te: bool = False) -> Request: + h = headers(cl, te) + h += [("Host", "example.com")] + return Request(method="GET", target="/", headers=h) + + # Special cases where the headers are ignored: + for kwargs in [{}, {"cl": 100}, {"te": True}, {"cl": 100, "te": True}]: + kwargs = cast(Dict[str, Any], kwargs) + for meth, r in [ + (b"HEAD", resp(**kwargs)), + (b"GET", resp(status_code=204, **kwargs)), + (b"GET", resp(status_code=304, **kwargs)), + ]: + assert _body_framing(meth, r) == ("content-length", (0,)) + + # Transfer-encoding + for kwargs in [{"te": True}, {"cl": 100, "te": True}]: + kwargs = cast(Dict[str, Any], kwargs) + for meth, r in [(None, req(**kwargs)), (b"GET", resp(**kwargs))]: # type: ignore + assert _body_framing(meth, r) == ("chunked", ()) + + # Content-Length + for meth, r in [(None, req(cl=100)), (b"GET", resp(cl=100))]: # type: ignore + assert _body_framing(meth, r) == ("content-length", (100,)) + + # No headers + assert _body_framing(None, req()) == ("content-length", (0,)) # type: ignore + assert _body_framing(b"GET", resp()) == ("http/1.0", ()) + + +def test_Connection_basics_and_content_length() -> None: + with pytest.raises(ValueError): + Connection("CLIENT") # type: ignore + + p = ConnectionPair() + assert p.conn[CLIENT].our_role is CLIENT + assert p.conn[CLIENT].their_role is SERVER + assert p.conn[SERVER].our_role is SERVER + assert p.conn[SERVER].their_role is CLIENT + + data = p.send( + CLIENT, + Request( + method="GET", + target="/", + headers=[("Host", "example.com"), ("Content-Length", "10")], + ), + ) + assert data == ( + b"GET / HTTP/1.1\r\n" b"Host: example.com\r\n" b"Content-Length: 10\r\n\r\n" + ) + + for conn in p.conns: + assert conn.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + assert p.conn[CLIENT].our_state is SEND_BODY + assert p.conn[CLIENT].their_state is SEND_RESPONSE + assert p.conn[SERVER].our_state is SEND_RESPONSE + assert p.conn[SERVER].their_state is SEND_BODY + + assert p.conn[CLIENT].their_http_version is None + assert p.conn[SERVER].their_http_version == b"1.1" + + data = p.send(SERVER, InformationalResponse(status_code=100, headers=[])) # type: ignore[arg-type] + assert data == b"HTTP/1.1 100 \r\n\r\n" + + data = p.send(SERVER, Response(status_code=200, headers=[("Content-Length", "11")])) + assert data == b"HTTP/1.1 200 \r\nContent-Length: 11\r\n\r\n" + + for conn in p.conns: + assert conn.states == {CLIENT: SEND_BODY, SERVER: SEND_BODY} + + assert p.conn[CLIENT].their_http_version == b"1.1" + assert p.conn[SERVER].their_http_version == b"1.1" + + data = p.send(CLIENT, Data(data=b"12345")) + assert data == b"12345" + data = p.send( + CLIENT, Data(data=b"67890"), expect=[Data(data=b"67890"), EndOfMessage()] + ) + assert data == b"67890" + data = p.send(CLIENT, EndOfMessage(), expect=[]) + assert data == b"" + + for conn in p.conns: + assert conn.states == {CLIENT: DONE, SERVER: SEND_BODY} + + data = p.send(SERVER, Data(data=b"1234567890")) + assert data == b"1234567890" + data = p.send(SERVER, Data(data=b"1"), expect=[Data(data=b"1"), EndOfMessage()]) + assert data == b"1" + data = p.send(SERVER, EndOfMessage(), expect=[]) + assert data == b"" + + for conn in p.conns: + assert conn.states == {CLIENT: DONE, SERVER: DONE} + + +def test_chunked() -> None: + p = ConnectionPair() + + p.send( + CLIENT, + Request( + method="GET", + target="/", + headers=[("Host", "example.com"), ("Transfer-Encoding", "chunked")], + ), + ) + data = p.send(CLIENT, Data(data=b"1234567890", chunk_start=True, chunk_end=True)) + assert data == b"a\r\n1234567890\r\n" + data = p.send(CLIENT, Data(data=b"abcde", chunk_start=True, chunk_end=True)) + assert data == b"5\r\nabcde\r\n" + data = p.send(CLIENT, Data(data=b""), expect=[]) + assert data == b"" + data = p.send(CLIENT, EndOfMessage(headers=[("hello", "there")])) + assert data == b"0\r\nhello: there\r\n\r\n" + + p.send( + SERVER, Response(status_code=200, headers=[("Transfer-Encoding", "chunked")]) + ) + p.send(SERVER, Data(data=b"54321", chunk_start=True, chunk_end=True)) + p.send(SERVER, Data(data=b"12345", chunk_start=True, chunk_end=True)) + p.send(SERVER, EndOfMessage()) + + for conn in p.conns: + assert conn.states == {CLIENT: DONE, SERVER: DONE} + + +def test_chunk_boundaries() -> None: + conn = Connection(our_role=SERVER) + + request = ( + b"POST / HTTP/1.1\r\n" + b"Host: example.com\r\n" + b"Transfer-Encoding: chunked\r\n" + b"\r\n" + ) + conn.receive_data(request) + assert conn.next_event() == Request( + method="POST", + target="/", + headers=[("Host", "example.com"), ("Transfer-Encoding", "chunked")], + ) + assert conn.next_event() is NEED_DATA + + conn.receive_data(b"5\r\nhello\r\n") + assert conn.next_event() == Data(data=b"hello", chunk_start=True, chunk_end=True) + + conn.receive_data(b"5\r\nhel") + assert conn.next_event() == Data(data=b"hel", chunk_start=True, chunk_end=False) + + conn.receive_data(b"l") + assert conn.next_event() == Data(data=b"l", chunk_start=False, chunk_end=False) + + conn.receive_data(b"o\r\n") + assert conn.next_event() == Data(data=b"o", chunk_start=False, chunk_end=True) + + conn.receive_data(b"5\r\nhello") + assert conn.next_event() == Data(data=b"hello", chunk_start=True, chunk_end=True) + + conn.receive_data(b"\r\n") + assert conn.next_event() == NEED_DATA + + conn.receive_data(b"0\r\n\r\n") + assert conn.next_event() == EndOfMessage() + + +def test_client_talking_to_http10_server() -> None: + c = Connection(CLIENT) + c.send(Request(method="GET", target="/", headers=[("Host", "example.com")])) + c.send(EndOfMessage()) + assert c.our_state is DONE + # No content-length, so Http10 framing for body + assert receive_and_get(c, b"HTTP/1.0 200 OK\r\n\r\n") == [ + Response(status_code=200, headers=[], http_version="1.0", reason=b"OK") # type: ignore[arg-type] + ] + assert c.our_state is MUST_CLOSE + assert receive_and_get(c, b"12345") == [Data(data=b"12345")] + assert receive_and_get(c, b"67890") == [Data(data=b"67890")] + assert receive_and_get(c, b"") == [EndOfMessage(), ConnectionClosed()] + assert c.their_state is CLOSED + + +def test_server_talking_to_http10_client() -> None: + c = Connection(SERVER) + # No content-length, so no body + # NB: no host header + assert receive_and_get(c, b"GET / HTTP/1.0\r\n\r\n") == [ + Request(method="GET", target="/", headers=[], http_version="1.0"), # type: ignore[arg-type] + EndOfMessage(), + ] + assert c.their_state is MUST_CLOSE + + # We automatically Connection: close back at them + assert ( + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + == b"HTTP/1.1 200 \r\nConnection: close\r\n\r\n" + ) + + assert c.send(Data(data=b"12345")) == b"12345" + assert c.send(EndOfMessage()) == b"" + assert c.our_state is MUST_CLOSE + + # Check that it works if they do send Content-Length + c = Connection(SERVER) + # NB: no host header + assert receive_and_get(c, b"POST / HTTP/1.0\r\nContent-Length: 10\r\n\r\n1") == [ + Request( + method="POST", + target="/", + headers=[("Content-Length", "10")], + http_version="1.0", + ), + Data(data=b"1"), + ] + assert receive_and_get(c, b"234567890") == [Data(data=b"234567890"), EndOfMessage()] + assert c.their_state is MUST_CLOSE + assert receive_and_get(c, b"") == [ConnectionClosed()] + + +def test_automatic_transfer_encoding_in_response() -> None: + # Check that in responses, the user can specify either Transfer-Encoding: + # chunked or no framing at all, and in both cases we automatically select + # the right option depending on whether the peer speaks HTTP/1.0 or + # HTTP/1.1 + for user_headers in [ + [("Transfer-Encoding", "chunked")], + [], + # In fact, this even works if Content-Length is set, + # because if both are set then Transfer-Encoding wins + [("Transfer-Encoding", "chunked"), ("Content-Length", "100")], + ]: + user_headers = cast(List[Tuple[str, str]], user_headers) + p = ConnectionPair() + p.send( + CLIENT, + [ + Request(method="GET", target="/", headers=[("Host", "example.com")]), + EndOfMessage(), + ], + ) + # When speaking to HTTP/1.1 client, all of the above cases get + # normalized to Transfer-Encoding: chunked + p.send( + SERVER, + Response(status_code=200, headers=user_headers), + expect=Response( + status_code=200, headers=[("Transfer-Encoding", "chunked")] + ), + ) + + # When speaking to HTTP/1.0 client, all of the above cases get + # normalized to no-framing-headers + c = Connection(SERVER) + receive_and_get(c, b"GET / HTTP/1.0\r\n\r\n") + assert ( + c.send(Response(status_code=200, headers=user_headers)) + == b"HTTP/1.1 200 \r\nConnection: close\r\n\r\n" + ) + assert c.send(Data(data=b"12345")) == b"12345" + + +def test_automagic_connection_close_handling() -> None: + p = ConnectionPair() + # If the user explicitly sets Connection: close, then we notice and + # respect it + p.send( + CLIENT, + [ + Request( + method="GET", + target="/", + headers=[("Host", "example.com"), ("Connection", "close")], + ), + EndOfMessage(), + ], + ) + for conn in p.conns: + assert conn.states[CLIENT] is MUST_CLOSE + # And if the client sets it, the server automatically echoes it back + p.send( + SERVER, + # no header here... + [Response(status_code=204, headers=[]), EndOfMessage()], # type: ignore[arg-type] + # ...but oh look, it arrived anyway + expect=[ + Response(status_code=204, headers=[("connection", "close")]), + EndOfMessage(), + ], + ) + for conn in p.conns: + assert conn.states == {CLIENT: MUST_CLOSE, SERVER: MUST_CLOSE} + + +def test_100_continue() -> None: + def setup() -> ConnectionPair: + p = ConnectionPair() + p.send( + CLIENT, + Request( + method="GET", + target="/", + headers=[ + ("Host", "example.com"), + ("Content-Length", "100"), + ("Expect", "100-continue"), + ], + ), + ) + for conn in p.conns: + assert conn.client_is_waiting_for_100_continue + assert not p.conn[CLIENT].they_are_waiting_for_100_continue + assert p.conn[SERVER].they_are_waiting_for_100_continue + return p + + # Disabled by 100 Continue + p = setup() + p.send(SERVER, InformationalResponse(status_code=100, headers=[])) # type: ignore[arg-type] + for conn in p.conns: + assert not conn.client_is_waiting_for_100_continue + assert not conn.they_are_waiting_for_100_continue + + # Disabled by a real response + p = setup() + p.send( + SERVER, Response(status_code=200, headers=[("Transfer-Encoding", "chunked")]) + ) + for conn in p.conns: + assert not conn.client_is_waiting_for_100_continue + assert not conn.they_are_waiting_for_100_continue + + # Disabled by the client going ahead and sending stuff anyway + p = setup() + p.send(CLIENT, Data(data=b"12345")) + for conn in p.conns: + assert not conn.client_is_waiting_for_100_continue + assert not conn.they_are_waiting_for_100_continue + + +def test_max_incomplete_event_size_countermeasure() -> None: + # Infinitely long headers are definitely not okay + c = Connection(SERVER) + c.receive_data(b"GET / HTTP/1.0\r\nEndless: ") + assert c.next_event() is NEED_DATA + with pytest.raises(RemoteProtocolError): + while True: + c.receive_data(b"a" * 1024) + c.next_event() + + # Checking that the same header is accepted / rejected depending on the + # max_incomplete_event_size setting: + c = Connection(SERVER, max_incomplete_event_size=5000) + c.receive_data(b"GET / HTTP/1.0\r\nBig: ") + c.receive_data(b"a" * 4000) + c.receive_data(b"\r\n\r\n") + assert get_all_events(c) == [ + Request( + method="GET", target="/", http_version="1.0", headers=[("big", "a" * 4000)] + ), + EndOfMessage(), + ] + + c = Connection(SERVER, max_incomplete_event_size=4000) + c.receive_data(b"GET / HTTP/1.0\r\nBig: ") + c.receive_data(b"a" * 4000) + with pytest.raises(RemoteProtocolError): + c.next_event() + + # Temporarily exceeding the size limit is fine, as long as its done with + # complete events: + c = Connection(SERVER, max_incomplete_event_size=5000) + c.receive_data(b"GET / HTTP/1.0\r\nContent-Length: 10000") + c.receive_data(b"\r\n\r\n" + b"a" * 10000) + assert get_all_events(c) == [ + Request( + method="GET", + target="/", + http_version="1.0", + headers=[("Content-Length", "10000")], + ), + Data(data=b"a" * 10000), + EndOfMessage(), + ] + + c = Connection(SERVER, max_incomplete_event_size=100) + # Two pipelined requests to create a way-too-big receive buffer... but + # it's fine because we're not checking + c.receive_data( + b"GET /1 HTTP/1.1\r\nHost: a\r\n\r\n" + b"GET /2 HTTP/1.1\r\nHost: b\r\n\r\n" + b"X" * 1000 + ) + assert get_all_events(c) == [ + Request(method="GET", target="/1", headers=[("host", "a")]), + EndOfMessage(), + ] + # Even more data comes in, still no problem + c.receive_data(b"X" * 1000) + # We can respond and reuse to get the second pipelined request + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + c.start_next_cycle() + assert get_all_events(c) == [ + Request(method="GET", target="/2", headers=[("host", "b")]), + EndOfMessage(), + ] + # But once we unpause and try to read the next message, and find that it's + # incomplete and the buffer is *still* way too large, then *that's* a + # problem: + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + c.start_next_cycle() + with pytest.raises(RemoteProtocolError): + c.next_event() + + +def test_reuse_simple() -> None: + p = ConnectionPair() + p.send( + CLIENT, + [Request(method="GET", target="/", headers=[("Host", "a")]), EndOfMessage()], + ) + p.send( + SERVER, + [ + Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]), + EndOfMessage(), + ], + ) + for conn in p.conns: + assert conn.states == {CLIENT: DONE, SERVER: DONE} + conn.start_next_cycle() + + p.send( + CLIENT, + [ + Request(method="DELETE", target="/foo", headers=[("Host", "a")]), + EndOfMessage(), + ], + ) + p.send( + SERVER, + [ + Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]), + EndOfMessage(), + ], + ) + + +def test_pipelining() -> None: + # Client doesn't support pipelining, so we have to do this by hand + c = Connection(SERVER) + assert c.next_event() is NEED_DATA + # 3 requests all bunched up + c.receive_data( + b"GET /1 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n" + b"12345" + b"GET /2 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n" + b"67890" + b"GET /3 HTTP/1.1\r\nHost: a.com\r\n\r\n" + ) + assert get_all_events(c) == [ + Request( + method="GET", + target="/1", + headers=[("Host", "a.com"), ("Content-Length", "5")], + ), + Data(data=b"12345"), + EndOfMessage(), + ] + assert c.their_state is DONE + assert c.our_state is SEND_RESPONSE + + assert c.next_event() is PAUSED + + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + assert c.their_state is DONE + assert c.our_state is DONE + + c.start_next_cycle() + + assert get_all_events(c) == [ + Request( + method="GET", + target="/2", + headers=[("Host", "a.com"), ("Content-Length", "5")], + ), + Data(data=b"67890"), + EndOfMessage(), + ] + assert c.next_event() is PAUSED + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + c.start_next_cycle() + + assert get_all_events(c) == [ + Request(method="GET", target="/3", headers=[("Host", "a.com")]), + EndOfMessage(), + ] + # Doesn't pause this time, no trailing data + assert c.next_event() is NEED_DATA + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + + # Arrival of more data triggers pause + assert c.next_event() is NEED_DATA + c.receive_data(b"SADF") + assert c.next_event() is PAUSED + assert c.trailing_data == (b"SADF", False) + # If EOF arrives while paused, we don't see that either: + c.receive_data(b"") + assert c.trailing_data == (b"SADF", True) + assert c.next_event() is PAUSED + c.receive_data(b"") + assert c.next_event() is PAUSED + # Can't call receive_data with non-empty buf after closing it + with pytest.raises(RuntimeError): + c.receive_data(b"FDSA") + + +def test_protocol_switch() -> None: + for (req, deny, accept) in [ + ( + Request( + method="CONNECT", + target="example.com:443", + headers=[("Host", "foo"), ("Content-Length", "1")], + ), + Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]), + Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]), + ), + ( + Request( + method="GET", + target="/", + headers=[("Host", "foo"), ("Content-Length", "1"), ("Upgrade", "a, b")], + ), + Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]), + InformationalResponse(status_code=101, headers=[("Upgrade", "a")]), + ), + ( + Request( + method="CONNECT", + target="example.com:443", + headers=[("Host", "foo"), ("Content-Length", "1"), ("Upgrade", "a, b")], + ), + Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]), + # Accept CONNECT, not upgrade + Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]), + ), + ( + Request( + method="CONNECT", + target="example.com:443", + headers=[("Host", "foo"), ("Content-Length", "1"), ("Upgrade", "a, b")], + ), + Response(status_code=404, headers=[(b"transfer-encoding", b"chunked")]), + # Accept Upgrade, not CONNECT + InformationalResponse(status_code=101, headers=[("Upgrade", "b")]), + ), + ]: + + def setup() -> ConnectionPair: + p = ConnectionPair() + p.send(CLIENT, req) + # No switch-related state change stuff yet; the client has to + # finish the request before that kicks in + for conn in p.conns: + assert conn.states[CLIENT] is SEND_BODY + p.send(CLIENT, [Data(data=b"1"), EndOfMessage()]) + for conn in p.conns: + assert conn.states[CLIENT] is MIGHT_SWITCH_PROTOCOL + assert p.conn[SERVER].next_event() is PAUSED + return p + + # Test deny case + p = setup() + p.send(SERVER, deny) + for conn in p.conns: + assert conn.states == {CLIENT: DONE, SERVER: SEND_BODY} + p.send(SERVER, EndOfMessage()) + # Check that re-use is still allowed after a denial + for conn in p.conns: + conn.start_next_cycle() + + # Test accept case + p = setup() + p.send(SERVER, accept) + for conn in p.conns: + assert conn.states == {CLIENT: SWITCHED_PROTOCOL, SERVER: SWITCHED_PROTOCOL} + conn.receive_data(b"123") + assert conn.next_event() is PAUSED + conn.receive_data(b"456") + assert conn.next_event() is PAUSED + assert conn.trailing_data == (b"123456", False) + + # Pausing in might-switch, then recovery + # (weird artificial case where the trailing data actually is valid + # HTTP for some reason, because this makes it easier to test the state + # logic) + p = setup() + sc = p.conn[SERVER] + sc.receive_data(b"GET / HTTP/1.0\r\n\r\n") + assert sc.next_event() is PAUSED + assert sc.trailing_data == (b"GET / HTTP/1.0\r\n\r\n", False) + sc.send(deny) + assert sc.next_event() is PAUSED + sc.send(EndOfMessage()) + sc.start_next_cycle() + assert get_all_events(sc) == [ + Request(method="GET", target="/", headers=[], http_version="1.0"), # type: ignore[arg-type] + EndOfMessage(), + ] + + # When we're DONE, have no trailing data, and the connection gets + # closed, we report ConnectionClosed(). When we're in might-switch or + # switched, we don't. + p = setup() + sc = p.conn[SERVER] + sc.receive_data(b"") + assert sc.next_event() is PAUSED + assert sc.trailing_data == (b"", True) + p.send(SERVER, accept) + assert sc.next_event() is PAUSED + + p = setup() + sc = p.conn[SERVER] + sc.receive_data(b"") + assert sc.next_event() is PAUSED + sc.send(deny) + assert sc.next_event() == ConnectionClosed() + + # You can't send after switching protocols, or while waiting for a + # protocol switch + p = setup() + with pytest.raises(LocalProtocolError): + p.conn[CLIENT].send( + Request(method="GET", target="/", headers=[("Host", "a")]) + ) + p = setup() + p.send(SERVER, accept) + with pytest.raises(LocalProtocolError): + p.conn[SERVER].send(Data(data=b"123")) + + +def test_close_simple() -> None: + # Just immediately closing a new connection without anything having + # happened yet. + for (who_shot_first, who_shot_second) in [(CLIENT, SERVER), (SERVER, CLIENT)]: + + def setup() -> ConnectionPair: + p = ConnectionPair() + p.send(who_shot_first, ConnectionClosed()) + for conn in p.conns: + assert conn.states == { + who_shot_first: CLOSED, + who_shot_second: MUST_CLOSE, + } + return p + + # You can keep putting b"" into a closed connection, and you keep + # getting ConnectionClosed() out: + p = setup() + assert p.conn[who_shot_second].next_event() == ConnectionClosed() + assert p.conn[who_shot_second].next_event() == ConnectionClosed() + p.conn[who_shot_second].receive_data(b"") + assert p.conn[who_shot_second].next_event() == ConnectionClosed() + # Second party can close... + p = setup() + p.send(who_shot_second, ConnectionClosed()) + for conn in p.conns: + assert conn.our_state is CLOSED + assert conn.their_state is CLOSED + # But trying to receive new data on a closed connection is a + # RuntimeError (not ProtocolError, because the problem here isn't + # violation of HTTP, it's violation of physics) + p = setup() + with pytest.raises(RuntimeError): + p.conn[who_shot_second].receive_data(b"123") + # And receiving new data on a MUST_CLOSE connection is a ProtocolError + p = setup() + p.conn[who_shot_first].receive_data(b"GET") + with pytest.raises(RemoteProtocolError): + p.conn[who_shot_first].next_event() + + +def test_close_different_states() -> None: + req = [ + Request(method="GET", target="/foo", headers=[("Host", "a")]), + EndOfMessage(), + ] + resp = [ + Response(status_code=200, headers=[(b"transfer-encoding", b"chunked")]), + EndOfMessage(), + ] + + # Client before request + p = ConnectionPair() + p.send(CLIENT, ConnectionClosed()) + for conn in p.conns: + assert conn.states == {CLIENT: CLOSED, SERVER: MUST_CLOSE} + + # Client after request + p = ConnectionPair() + p.send(CLIENT, req) + p.send(CLIENT, ConnectionClosed()) + for conn in p.conns: + assert conn.states == {CLIENT: CLOSED, SERVER: SEND_RESPONSE} + + # Server after request -> not allowed + p = ConnectionPair() + p.send(CLIENT, req) + with pytest.raises(LocalProtocolError): + p.conn[SERVER].send(ConnectionClosed()) + p.conn[CLIENT].receive_data(b"") + with pytest.raises(RemoteProtocolError): + p.conn[CLIENT].next_event() + + # Server after response + p = ConnectionPair() + p.send(CLIENT, req) + p.send(SERVER, resp) + p.send(SERVER, ConnectionClosed()) + for conn in p.conns: + assert conn.states == {CLIENT: MUST_CLOSE, SERVER: CLOSED} + + # Both after closing (ConnectionClosed() is idempotent) + p = ConnectionPair() + p.send(CLIENT, req) + p.send(SERVER, resp) + p.send(CLIENT, ConnectionClosed()) + p.send(SERVER, ConnectionClosed()) + p.send(CLIENT, ConnectionClosed()) + p.send(SERVER, ConnectionClosed()) + + # In the middle of sending -> not allowed + p = ConnectionPair() + p.send( + CLIENT, + Request( + method="GET", target="/", headers=[("Host", "a"), ("Content-Length", "10")] + ), + ) + with pytest.raises(LocalProtocolError): + p.conn[CLIENT].send(ConnectionClosed()) + p.conn[SERVER].receive_data(b"") + with pytest.raises(RemoteProtocolError): + p.conn[SERVER].next_event() + + +# Receive several requests and then client shuts down their side of the +# connection; we can respond to each +def test_pipelined_close() -> None: + c = Connection(SERVER) + # 2 requests then a close + c.receive_data( + b"GET /1 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n" + b"12345" + b"GET /2 HTTP/1.1\r\nHost: a.com\r\nContent-Length: 5\r\n\r\n" + b"67890" + ) + c.receive_data(b"") + assert get_all_events(c) == [ + Request( + method="GET", + target="/1", + headers=[("host", "a.com"), ("content-length", "5")], + ), + Data(data=b"12345"), + EndOfMessage(), + ] + assert c.states[CLIENT] is DONE + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + assert c.states[SERVER] is DONE + c.start_next_cycle() + assert get_all_events(c) == [ + Request( + method="GET", + target="/2", + headers=[("host", "a.com"), ("content-length", "5")], + ), + Data(data=b"67890"), + EndOfMessage(), + ConnectionClosed(), + ] + assert c.states == {CLIENT: CLOSED, SERVER: SEND_RESPONSE} + c.send(Response(status_code=200, headers=[])) # type: ignore[arg-type] + c.send(EndOfMessage()) + assert c.states == {CLIENT: CLOSED, SERVER: MUST_CLOSE} + c.send(ConnectionClosed()) + assert c.states == {CLIENT: CLOSED, SERVER: CLOSED} + + +def test_sendfile() -> None: + class SendfilePlaceholder: + def __len__(self) -> int: + return 10 + + placeholder = SendfilePlaceholder() + + def setup( + header: Tuple[str, str], http_version: str + ) -> Tuple[Connection, Optional[List[bytes]]]: + c = Connection(SERVER) + receive_and_get( + c, "GET / HTTP/{}\r\nHost: a\r\n\r\n".format(http_version).encode("ascii") + ) + headers = [] + if header: + headers.append(header) + c.send(Response(status_code=200, headers=headers)) + return c, c.send_with_data_passthrough(Data(data=placeholder)) # type: ignore + + c, data = setup(("Content-Length", "10"), "1.1") + assert data == [placeholder] # type: ignore + # Raises an error if the connection object doesn't think we've sent + # exactly 10 bytes + c.send(EndOfMessage()) + + _, data = setup(("Transfer-Encoding", "chunked"), "1.1") + assert placeholder in data # type: ignore + data[data.index(placeholder)] = b"x" * 10 # type: ignore + assert b"".join(data) == b"a\r\nxxxxxxxxxx\r\n" # type: ignore + + c, data = setup(None, "1.0") # type: ignore + assert data == [placeholder] # type: ignore + assert c.our_state is SEND_BODY + + +def test_errors() -> None: + # After a receive error, you can't receive + for role in [CLIENT, SERVER]: + c = Connection(our_role=role) + c.receive_data(b"gibberish\r\n\r\n") + with pytest.raises(RemoteProtocolError): + c.next_event() + # Now any attempt to receive continues to raise + assert c.their_state is ERROR + assert c.our_state is not ERROR + print(c._cstate.states) + with pytest.raises(RemoteProtocolError): + c.next_event() + # But we can still yell at the client for sending us gibberish + if role is SERVER: + assert ( + c.send(Response(status_code=400, headers=[])) # type: ignore[arg-type] + == b"HTTP/1.1 400 \r\nConnection: close\r\n\r\n" + ) + + # After an error sending, you can no longer send + # (This is especially important for things like content-length errors, + # where there's complex internal state being modified) + def conn(role: Type[Sentinel]) -> Connection: + c = Connection(our_role=role) + if role is SERVER: + # Put it into the state where it *could* send a response... + receive_and_get(c, b"GET / HTTP/1.0\r\n\r\n") + assert c.our_state is SEND_RESPONSE + return c + + for role in [CLIENT, SERVER]: + if role is CLIENT: + # This HTTP/1.0 request won't be detected as bad until after we go + # through the state machine and hit the writing code + good = Request(method="GET", target="/", headers=[("Host", "example.com")]) + bad = Request( + method="GET", + target="/", + headers=[("Host", "example.com")], + http_version="1.0", + ) + elif role is SERVER: + good = Response(status_code=200, headers=[]) # type: ignore[arg-type,assignment] + bad = Response(status_code=200, headers=[], http_version="1.0") # type: ignore[arg-type,assignment] + # Make sure 'good' actually is good + c = conn(role) + c.send(good) + assert c.our_state is not ERROR + # Do that again, but this time sending 'bad' first + c = conn(role) + with pytest.raises(LocalProtocolError): + c.send(bad) + assert c.our_state is ERROR + assert c.their_state is not ERROR + # Now 'good' is not so good + with pytest.raises(LocalProtocolError): + c.send(good) + + # And check send_failed() too + c = conn(role) + c.send_failed() + assert c.our_state is ERROR + assert c.their_state is not ERROR + # This is idempotent + c.send_failed() + assert c.our_state is ERROR + assert c.their_state is not ERROR + + +def test_idle_receive_nothing() -> None: + # At one point this incorrectly raised an error + for role in [CLIENT, SERVER]: + c = Connection(role) + assert c.next_event() is NEED_DATA + + +def test_connection_drop() -> None: + c = Connection(SERVER) + c.receive_data(b"GET /") + assert c.next_event() is NEED_DATA + c.receive_data(b"") + with pytest.raises(RemoteProtocolError): + c.next_event() + + +def test_408_request_timeout() -> None: + # Should be able to send this spontaneously as a server without seeing + # anything from client + p = ConnectionPair() + p.send(SERVER, Response(status_code=408, headers=[(b"connection", b"close")])) + + +# This used to raise IndexError +def test_empty_request() -> None: + c = Connection(SERVER) + c.receive_data(b"\r\n") + with pytest.raises(RemoteProtocolError): + c.next_event() + + +# This used to raise IndexError +def test_empty_response() -> None: + c = Connection(CLIENT) + c.send(Request(method="GET", target="/", headers=[("Host", "a")])) + c.receive_data(b"\r\n") + with pytest.raises(RemoteProtocolError): + c.next_event() + + +@pytest.mark.parametrize( + "data", + [ + b"\x00", + b"\x20", + b"\x16\x03\x01\x00\xa5", # Typical start of a TLS Client Hello + ], +) +def test_early_detection_of_invalid_request(data: bytes) -> None: + c = Connection(SERVER) + # Early detection should occur before even receiving a `\r\n` + c.receive_data(data) + with pytest.raises(RemoteProtocolError): + c.next_event() + + +@pytest.mark.parametrize( + "data", + [ + b"\x00", + b"\x20", + b"\x16\x03\x03\x00\x31", # Typical start of a TLS Server Hello + ], +) +def test_early_detection_of_invalid_response(data: bytes) -> None: + c = Connection(CLIENT) + # Early detection should occur before even receiving a `\r\n` + c.receive_data(data) + with pytest.raises(RemoteProtocolError): + c.next_event() + + +# This used to give different headers for HEAD and GET. +# The correct way to handle HEAD is to put whatever headers we *would* have +# put if it were a GET -- even though we know that for HEAD, those headers +# will be ignored. +def test_HEAD_framing_headers() -> None: + def setup(method: bytes, http_version: bytes) -> Connection: + c = Connection(SERVER) + c.receive_data( + method + b" / HTTP/" + http_version + b"\r\n" + b"Host: example.com\r\n\r\n" + ) + assert type(c.next_event()) is Request + assert type(c.next_event()) is EndOfMessage + return c + + for method in [b"GET", b"HEAD"]: + # No Content-Length, HTTP/1.1 peer, should use chunked + c = setup(method, b"1.1") + assert ( + c.send(Response(status_code=200, headers=[])) == b"HTTP/1.1 200 \r\n" # type: ignore[arg-type] + b"Transfer-Encoding: chunked\r\n\r\n" + ) + + # No Content-Length, HTTP/1.0 peer, frame with connection: close + c = setup(method, b"1.0") + assert ( + c.send(Response(status_code=200, headers=[])) == b"HTTP/1.1 200 \r\n" # type: ignore[arg-type] + b"Connection: close\r\n\r\n" + ) + + # Content-Length + Transfer-Encoding, TE wins + c = setup(method, b"1.1") + assert ( + c.send( + Response( + status_code=200, + headers=[ + ("Content-Length", "100"), + ("Transfer-Encoding", "chunked"), + ], + ) + ) + == b"HTTP/1.1 200 \r\n" + b"Transfer-Encoding: chunked\r\n\r\n" + ) + + +def test_special_exceptions_for_lost_connection_in_message_body() -> None: + c = Connection(SERVER) + c.receive_data( + b"POST / HTTP/1.1\r\n" b"Host: example.com\r\n" b"Content-Length: 100\r\n\r\n" + ) + assert type(c.next_event()) is Request + assert c.next_event() is NEED_DATA + c.receive_data(b"12345") + assert c.next_event() == Data(data=b"12345") + c.receive_data(b"") + with pytest.raises(RemoteProtocolError) as excinfo: + c.next_event() + assert "received 5 bytes" in str(excinfo.value) + assert "expected 100" in str(excinfo.value) + + c = Connection(SERVER) + c.receive_data( + b"POST / HTTP/1.1\r\n" + b"Host: example.com\r\n" + b"Transfer-Encoding: chunked\r\n\r\n" + ) + assert type(c.next_event()) is Request + assert c.next_event() is NEED_DATA + c.receive_data(b"8\r\n012345") + assert c.next_event().data == b"012345" # type: ignore + c.receive_data(b"") + with pytest.raises(RemoteProtocolError) as excinfo: + c.next_event() + assert "incomplete chunked read" in str(excinfo.value) diff --git a/.venv/Lib/site-packages/h11/tests/test_events.py b/.venv/Lib/site-packages/h11/tests/test_events.py new file mode 100644 index 0000000..bc6c313 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_events.py @@ -0,0 +1,150 @@ +from http import HTTPStatus + +import pytest + +from .. import _events +from .._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from .._util import LocalProtocolError + + +def test_events() -> None: + with pytest.raises(LocalProtocolError): + # Missing Host: + req = Request( + method="GET", target="/", headers=[("a", "b")], http_version="1.1" + ) + # But this is okay (HTTP/1.0) + req = Request(method="GET", target="/", headers=[("a", "b")], http_version="1.0") + # fields are normalized + assert req.method == b"GET" + assert req.target == b"/" + assert req.headers == [(b"a", b"b")] + assert req.http_version == b"1.0" + + # This is also okay -- has a Host (with weird capitalization, which is ok) + req = Request( + method="GET", + target="/", + headers=[("a", "b"), ("hOSt", "example.com")], + http_version="1.1", + ) + # we normalize header capitalization + assert req.headers == [(b"a", b"b"), (b"host", b"example.com")] + + # Multiple host is bad too + with pytest.raises(LocalProtocolError): + req = Request( + method="GET", + target="/", + headers=[("Host", "a"), ("Host", "a")], + http_version="1.1", + ) + # Even for HTTP/1.0 + with pytest.raises(LocalProtocolError): + req = Request( + method="GET", + target="/", + headers=[("Host", "a"), ("Host", "a")], + http_version="1.0", + ) + + # Header values are validated + for bad_char in "\x00\r\n\f\v": + with pytest.raises(LocalProtocolError): + req = Request( + method="GET", + target="/", + headers=[("Host", "a"), ("Foo", "asd" + bad_char)], + http_version="1.0", + ) + + # But for compatibility we allow non-whitespace control characters, even + # though they're forbidden by the spec. + Request( + method="GET", + target="/", + headers=[("Host", "a"), ("Foo", "asd\x01\x02\x7f")], + http_version="1.0", + ) + + # Request target is validated + for bad_byte in b"\x00\x20\x7f\xee": + target = bytearray(b"/") + target.append(bad_byte) + with pytest.raises(LocalProtocolError): + Request( + method="GET", target=target, headers=[("Host", "a")], http_version="1.1" + ) + + # Request method is validated + with pytest.raises(LocalProtocolError): + Request( + method="GET / HTTP/1.1", + target=target, + headers=[("Host", "a")], + http_version="1.1", + ) + + ir = InformationalResponse(status_code=100, headers=[("Host", "a")]) + assert ir.status_code == 100 + assert ir.headers == [(b"host", b"a")] + assert ir.http_version == b"1.1" + + with pytest.raises(LocalProtocolError): + InformationalResponse(status_code=200, headers=[("Host", "a")]) + + resp = Response(status_code=204, headers=[], http_version="1.0") # type: ignore[arg-type] + assert resp.status_code == 204 + assert resp.headers == [] + assert resp.http_version == b"1.0" + + with pytest.raises(LocalProtocolError): + resp = Response(status_code=100, headers=[], http_version="1.0") # type: ignore[arg-type] + + with pytest.raises(LocalProtocolError): + Response(status_code="100", headers=[], http_version="1.0") # type: ignore[arg-type] + + with pytest.raises(LocalProtocolError): + InformationalResponse(status_code=b"100", headers=[], http_version="1.0") # type: ignore[arg-type] + + d = Data(data=b"asdf") + assert d.data == b"asdf" + + eom = EndOfMessage() + assert eom.headers == [] + + cc = ConnectionClosed() + assert repr(cc) == "ConnectionClosed()" + + +def test_intenum_status_code() -> None: + # https://github.com/python-hyper/h11/issues/72 + + r = Response(status_code=HTTPStatus.OK, headers=[], http_version="1.0") # type: ignore[arg-type] + assert r.status_code == HTTPStatus.OK + assert type(r.status_code) is not type(HTTPStatus.OK) + assert type(r.status_code) is int + + +def test_header_casing() -> None: + r = Request( + method="GET", + target="/", + headers=[("Host", "example.org"), ("Connection", "keep-alive")], + http_version="1.1", + ) + assert len(r.headers) == 2 + assert r.headers[0] == (b"host", b"example.org") + assert r.headers == [(b"host", b"example.org"), (b"connection", b"keep-alive")] + assert r.headers.raw_items() == [ + (b"Host", b"example.org"), + (b"Connection", b"keep-alive"), + ] diff --git a/.venv/Lib/site-packages/h11/tests/test_headers.py b/.venv/Lib/site-packages/h11/tests/test_headers.py new file mode 100644 index 0000000..ba53d08 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_headers.py @@ -0,0 +1,157 @@ +import pytest + +from .._events import Request +from .._headers import ( + get_comma_header, + has_expect_100_continue, + Headers, + normalize_and_validate, + set_comma_header, +) +from .._util import LocalProtocolError + + +def test_normalize_and_validate() -> None: + assert normalize_and_validate([("foo", "bar")]) == [(b"foo", b"bar")] + assert normalize_and_validate([(b"foo", b"bar")]) == [(b"foo", b"bar")] + + # no leading/trailing whitespace in names + with pytest.raises(LocalProtocolError): + normalize_and_validate([(b"foo ", "bar")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([(b" foo", "bar")]) + + # no weird characters in names + with pytest.raises(LocalProtocolError) as excinfo: + normalize_and_validate([(b"foo bar", b"baz")]) + assert "foo bar" in str(excinfo.value) + with pytest.raises(LocalProtocolError): + normalize_and_validate([(b"foo\x00bar", b"baz")]) + # Not even 8-bit characters: + with pytest.raises(LocalProtocolError): + normalize_and_validate([(b"foo\xffbar", b"baz")]) + # And not even the control characters we allow in values: + with pytest.raises(LocalProtocolError): + normalize_and_validate([(b"foo\x01bar", b"baz")]) + + # no return or NUL characters in values + with pytest.raises(LocalProtocolError) as excinfo: + normalize_and_validate([("foo", "bar\rbaz")]) + assert "bar\\rbaz" in str(excinfo.value) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("foo", "bar\nbaz")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("foo", "bar\x00baz")]) + # no leading/trailing whitespace + with pytest.raises(LocalProtocolError): + normalize_and_validate([("foo", "barbaz ")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("foo", " barbaz")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("foo", "barbaz\t")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("foo", "\tbarbaz")]) + + # content-length + assert normalize_and_validate([("Content-Length", "1")]) == [ + (b"content-length", b"1") + ] + with pytest.raises(LocalProtocolError): + normalize_and_validate([("Content-Length", "asdf")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("Content-Length", "1x")]) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("Content-Length", "1"), ("Content-Length", "2")]) + assert normalize_and_validate( + [("Content-Length", "0"), ("Content-Length", "0")] + ) == [(b"content-length", b"0")] + assert normalize_and_validate([("Content-Length", "0 , 0")]) == [ + (b"content-length", b"0") + ] + with pytest.raises(LocalProtocolError): + normalize_and_validate( + [("Content-Length", "1"), ("Content-Length", "1"), ("Content-Length", "2")] + ) + with pytest.raises(LocalProtocolError): + normalize_and_validate([("Content-Length", "1 , 1,2")]) + + # transfer-encoding + assert normalize_and_validate([("Transfer-Encoding", "chunked")]) == [ + (b"transfer-encoding", b"chunked") + ] + assert normalize_and_validate([("Transfer-Encoding", "cHuNkEd")]) == [ + (b"transfer-encoding", b"chunked") + ] + with pytest.raises(LocalProtocolError) as excinfo: + normalize_and_validate([("Transfer-Encoding", "gzip")]) + assert excinfo.value.error_status_hint == 501 # Not Implemented + with pytest.raises(LocalProtocolError) as excinfo: + normalize_and_validate( + [("Transfer-Encoding", "chunked"), ("Transfer-Encoding", "gzip")] + ) + assert excinfo.value.error_status_hint == 501 # Not Implemented + + +def test_get_set_comma_header() -> None: + headers = normalize_and_validate( + [ + ("Connection", "close"), + ("whatever", "something"), + ("connectiON", "fOo,, , BAR"), + ] + ) + + assert get_comma_header(headers, b"connection") == [b"close", b"foo", b"bar"] + + headers = set_comma_header(headers, b"newthing", ["a", "b"]) # type: ignore + + with pytest.raises(LocalProtocolError): + set_comma_header(headers, b"newthing", [" a", "b"]) # type: ignore + + assert headers == [ + (b"connection", b"close"), + (b"whatever", b"something"), + (b"connection", b"fOo,, , BAR"), + (b"newthing", b"a"), + (b"newthing", b"b"), + ] + + headers = set_comma_header(headers, b"whatever", ["different thing"]) # type: ignore + + assert headers == [ + (b"connection", b"close"), + (b"connection", b"fOo,, , BAR"), + (b"newthing", b"a"), + (b"newthing", b"b"), + (b"whatever", b"different thing"), + ] + + +def test_has_100_continue() -> None: + assert has_expect_100_continue( + Request( + method="GET", + target="/", + headers=[("Host", "example.com"), ("Expect", "100-continue")], + ) + ) + assert not has_expect_100_continue( + Request(method="GET", target="/", headers=[("Host", "example.com")]) + ) + # Case insensitive + assert has_expect_100_continue( + Request( + method="GET", + target="/", + headers=[("Host", "example.com"), ("Expect", "100-Continue")], + ) + ) + # Doesn't work in HTTP/1.0 + assert not has_expect_100_continue( + Request( + method="GET", + target="/", + headers=[("Host", "example.com"), ("Expect", "100-continue")], + http_version="1.0", + ) + ) diff --git a/.venv/Lib/site-packages/h11/tests/test_helpers.py b/.venv/Lib/site-packages/h11/tests/test_helpers.py new file mode 100644 index 0000000..c329c76 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_helpers.py @@ -0,0 +1,32 @@ +from .._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from .helpers import normalize_data_events + + +def test_normalize_data_events() -> None: + assert normalize_data_events( + [ + Data(data=bytearray(b"1")), + Data(data=b"2"), + Response(status_code=200, headers=[]), # type: ignore[arg-type] + Data(data=b"3"), + Data(data=b"4"), + EndOfMessage(), + Data(data=b"5"), + Data(data=b"6"), + Data(data=b"7"), + ] + ) == [ + Data(data=b"12"), + Response(status_code=200, headers=[]), # type: ignore[arg-type] + Data(data=b"34"), + EndOfMessage(), + Data(data=b"567"), + ] diff --git a/.venv/Lib/site-packages/h11/tests/test_io.py b/.venv/Lib/site-packages/h11/tests/test_io.py new file mode 100644 index 0000000..2b47c0e --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_io.py @@ -0,0 +1,572 @@ +from typing import Any, Callable, Generator, List + +import pytest + +from .._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from .._headers import Headers, normalize_and_validate +from .._readers import ( + _obsolete_line_fold, + ChunkedReader, + ContentLengthReader, + Http10Reader, + READERS, +) +from .._receivebuffer import ReceiveBuffer +from .._state import ( + CLIENT, + CLOSED, + DONE, + IDLE, + MIGHT_SWITCH_PROTOCOL, + MUST_CLOSE, + SEND_BODY, + SEND_RESPONSE, + SERVER, + SWITCHED_PROTOCOL, +) +from .._util import LocalProtocolError +from .._writers import ( + ChunkedWriter, + ContentLengthWriter, + Http10Writer, + write_any_response, + write_headers, + write_request, + WRITERS, +) +from .helpers import normalize_data_events + +SIMPLE_CASES = [ + ( + (CLIENT, IDLE), + Request( + method="GET", + target="/a", + headers=[("Host", "foo"), ("Connection", "close")], + ), + b"GET /a HTTP/1.1\r\nHost: foo\r\nConnection: close\r\n\r\n", + ), + ( + (SERVER, SEND_RESPONSE), + Response(status_code=200, headers=[("Connection", "close")], reason=b"OK"), + b"HTTP/1.1 200 OK\r\nConnection: close\r\n\r\n", + ), + ( + (SERVER, SEND_RESPONSE), + Response(status_code=200, headers=[], reason=b"OK"), # type: ignore[arg-type] + b"HTTP/1.1 200 OK\r\n\r\n", + ), + ( + (SERVER, SEND_RESPONSE), + InformationalResponse( + status_code=101, headers=[("Upgrade", "websocket")], reason=b"Upgrade" + ), + b"HTTP/1.1 101 Upgrade\r\nUpgrade: websocket\r\n\r\n", + ), + ( + (SERVER, SEND_RESPONSE), + InformationalResponse(status_code=101, headers=[], reason=b"Upgrade"), # type: ignore[arg-type] + b"HTTP/1.1 101 Upgrade\r\n\r\n", + ), +] + + +def dowrite(writer: Callable[..., None], obj: Any) -> bytes: + got_list: List[bytes] = [] + writer(obj, got_list.append) + return b"".join(got_list) + + +def tw(writer: Any, obj: Any, expected: Any) -> None: + got = dowrite(writer, obj) + assert got == expected + + +def makebuf(data: bytes) -> ReceiveBuffer: + buf = ReceiveBuffer() + buf += data + return buf + + +def tr(reader: Any, data: bytes, expected: Any) -> None: + def check(got: Any) -> None: + assert got == expected + # Headers should always be returned as bytes, not e.g. bytearray + # https://github.com/python-hyper/wsproto/pull/54#issuecomment-377709478 + for name, value in getattr(got, "headers", []): + assert type(name) is bytes + assert type(value) is bytes + + # Simple: consume whole thing + buf = makebuf(data) + check(reader(buf)) + assert not buf + + # Incrementally growing buffer + buf = ReceiveBuffer() + for i in range(len(data)): + assert reader(buf) is None + buf += data[i : i + 1] + check(reader(buf)) + + # Trailing data + buf = makebuf(data) + buf += b"trailing" + check(reader(buf)) + assert bytes(buf) == b"trailing" + + +def test_writers_simple() -> None: + for ((role, state), event, binary) in SIMPLE_CASES: + tw(WRITERS[role, state], event, binary) + + +def test_readers_simple() -> None: + for ((role, state), event, binary) in SIMPLE_CASES: + tr(READERS[role, state], binary, event) + + +def test_writers_unusual() -> None: + # Simple test of the write_headers utility routine + tw( + write_headers, + normalize_and_validate([("foo", "bar"), ("baz", "quux")]), + b"foo: bar\r\nbaz: quux\r\n\r\n", + ) + tw(write_headers, Headers([]), b"\r\n") + + # We understand HTTP/1.0, but we don't speak it + with pytest.raises(LocalProtocolError): + tw( + write_request, + Request( + method="GET", + target="/", + headers=[("Host", "foo"), ("Connection", "close")], + http_version="1.0", + ), + None, + ) + with pytest.raises(LocalProtocolError): + tw( + write_any_response, + Response( + status_code=200, headers=[("Connection", "close")], http_version="1.0" + ), + None, + ) + + +def test_readers_unusual() -> None: + # Reading HTTP/1.0 + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.0\r\nSome: header\r\n\r\n", + Request( + method="HEAD", + target="/foo", + headers=[("Some", "header")], + http_version="1.0", + ), + ) + + # check no-headers, since it's only legal with HTTP/1.0 + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.0\r\n\r\n", + Request(method="HEAD", target="/foo", headers=[], http_version="1.0"), # type: ignore[arg-type] + ) + + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.0 200 OK\r\nSome: header\r\n\r\n", + Response( + status_code=200, + headers=[("Some", "header")], + http_version="1.0", + reason=b"OK", + ), + ) + + # single-character header values (actually disallowed by the ABNF in RFC + # 7230 -- this is a bug in the standard that we originally copied...) + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.0 200 OK\r\n" b"Foo: a a a a a \r\n\r\n", + Response( + status_code=200, + headers=[("Foo", "a a a a a")], + http_version="1.0", + reason=b"OK", + ), + ) + + # Empty headers -- also legal + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.0 200 OK\r\n" b"Foo:\r\n\r\n", + Response( + status_code=200, headers=[("Foo", "")], http_version="1.0", reason=b"OK" + ), + ) + + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.0 200 OK\r\n" b"Foo: \t \t \r\n\r\n", + Response( + status_code=200, headers=[("Foo", "")], http_version="1.0", reason=b"OK" + ), + ) + + # Tolerate broken servers that leave off the response code + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.0 200\r\n" b"Foo: bar\r\n\r\n", + Response( + status_code=200, headers=[("Foo", "bar")], http_version="1.0", reason=b"" + ), + ) + + # Tolerate headers line endings (\r\n and \n) + # \n\r\b between headers and body + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.1 200 OK\r\nSomeHeader: val\n\r\n", + Response( + status_code=200, + headers=[("SomeHeader", "val")], + http_version="1.1", + reason="OK", + ), + ) + + # delimited only with \n + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.1 200 OK\nSomeHeader1: val1\nSomeHeader2: val2\n\n", + Response( + status_code=200, + headers=[("SomeHeader1", "val1"), ("SomeHeader2", "val2")], + http_version="1.1", + reason="OK", + ), + ) + + # mixed \r\n and \n + tr( + READERS[SERVER, SEND_RESPONSE], + b"HTTP/1.1 200 OK\r\nSomeHeader1: val1\nSomeHeader2: val2\n\r\n", + Response( + status_code=200, + headers=[("SomeHeader1", "val1"), ("SomeHeader2", "val2")], + http_version="1.1", + reason="OK", + ), + ) + + # obsolete line folding + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" + b"Host: example.com\r\n" + b"Some: multi-line\r\n" + b" header\r\n" + b"\tnonsense\r\n" + b" \t \t\tI guess\r\n" + b"Connection: close\r\n" + b"More-nonsense: in the\r\n" + b" last header \r\n\r\n", + Request( + method="HEAD", + target="/foo", + headers=[ + ("Host", "example.com"), + ("Some", "multi-line header nonsense I guess"), + ("Connection", "close"), + ("More-nonsense", "in the last header"), + ], + ), + ) + + with pytest.raises(LocalProtocolError): + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" b" folded: line\r\n\r\n", + None, + ) + + with pytest.raises(LocalProtocolError): + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" b"foo : line\r\n\r\n", + None, + ) + with pytest.raises(LocalProtocolError): + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" b"foo\t: line\r\n\r\n", + None, + ) + with pytest.raises(LocalProtocolError): + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" b"foo\t: line\r\n\r\n", + None, + ) + with pytest.raises(LocalProtocolError): + tr(READERS[CLIENT, IDLE], b"HEAD /foo HTTP/1.1\r\n" b": line\r\n\r\n", None) + + +def test__obsolete_line_fold_bytes() -> None: + # _obsolete_line_fold has a defensive cast to bytearray, which is + # necessary to protect against O(n^2) behavior in case anyone ever passes + # in regular bytestrings... but right now we never pass in regular + # bytestrings. so this test just exists to get some coverage on that + # defensive cast. + assert list(_obsolete_line_fold([b"aaa", b"bbb", b" ccc", b"ddd"])) == [ + b"aaa", + bytearray(b"bbb ccc"), + b"ddd", + ] + + +def _run_reader_iter( + reader: Any, buf: bytes, do_eof: bool +) -> Generator[Any, None, None]: + while True: + event = reader(buf) + if event is None: + break + yield event + # body readers have undefined behavior after returning EndOfMessage, + # because this changes the state so they don't get called again + if type(event) is EndOfMessage: + break + if do_eof: + assert not buf + yield reader.read_eof() + + +def _run_reader(*args: Any) -> List[Event]: + events = list(_run_reader_iter(*args)) + return normalize_data_events(events) + + +def t_body_reader(thunk: Any, data: bytes, expected: Any, do_eof: bool = False) -> None: + # Simple: consume whole thing + print("Test 1") + buf = makebuf(data) + assert _run_reader(thunk(), buf, do_eof) == expected + + # Incrementally growing buffer + print("Test 2") + reader = thunk() + buf = ReceiveBuffer() + events = [] + for i in range(len(data)): + events += _run_reader(reader, buf, False) + buf += data[i : i + 1] + events += _run_reader(reader, buf, do_eof) + assert normalize_data_events(events) == expected + + is_complete = any(type(event) is EndOfMessage for event in expected) + if is_complete and not do_eof: + buf = makebuf(data + b"trailing") + assert _run_reader(thunk(), buf, False) == expected + + +def test_ContentLengthReader() -> None: + t_body_reader(lambda: ContentLengthReader(0), b"", [EndOfMessage()]) + + t_body_reader( + lambda: ContentLengthReader(10), + b"0123456789", + [Data(data=b"0123456789"), EndOfMessage()], + ) + + +def test_Http10Reader() -> None: + t_body_reader(Http10Reader, b"", [EndOfMessage()], do_eof=True) + t_body_reader(Http10Reader, b"asdf", [Data(data=b"asdf")], do_eof=False) + t_body_reader( + Http10Reader, b"asdf", [Data(data=b"asdf"), EndOfMessage()], do_eof=True + ) + + +def test_ChunkedReader() -> None: + t_body_reader(ChunkedReader, b"0\r\n\r\n", [EndOfMessage()]) + + t_body_reader( + ChunkedReader, + b"0\r\nSome: header\r\n\r\n", + [EndOfMessage(headers=[("Some", "header")])], + ) + + t_body_reader( + ChunkedReader, + b"5\r\n01234\r\n" + + b"10\r\n0123456789abcdef\r\n" + + b"0\r\n" + + b"Some: header\r\n\r\n", + [ + Data(data=b"012340123456789abcdef"), + EndOfMessage(headers=[("Some", "header")]), + ], + ) + + t_body_reader( + ChunkedReader, + b"5\r\n01234\r\n" + b"10\r\n0123456789abcdef\r\n" + b"0\r\n\r\n", + [Data(data=b"012340123456789abcdef"), EndOfMessage()], + ) + + # handles upper and lowercase hex + t_body_reader( + ChunkedReader, + b"aA\r\n" + b"x" * 0xAA + b"\r\n" + b"0\r\n\r\n", + [Data(data=b"x" * 0xAA), EndOfMessage()], + ) + + # refuses arbitrarily long chunk integers + with pytest.raises(LocalProtocolError): + # Technically this is legal HTTP/1.1, but we refuse to process chunk + # sizes that don't fit into 20 characters of hex + t_body_reader(ChunkedReader, b"9" * 100 + b"\r\nxxx", [Data(data=b"xxx")]) + + # refuses garbage in the chunk count + with pytest.raises(LocalProtocolError): + t_body_reader(ChunkedReader, b"10\x00\r\nxxx", None) + + # handles (and discards) "chunk extensions" omg wtf + t_body_reader( + ChunkedReader, + b"5; hello=there\r\n" + + b"xxxxx" + + b"\r\n" + + b'0; random="junk"; some=more; canbe=lonnnnngg\r\n\r\n', + [Data(data=b"xxxxx"), EndOfMessage()], + ) + + t_body_reader( + ChunkedReader, + b"5 \r\n01234\r\n" + b"0\r\n\r\n", + [Data(data=b"01234"), EndOfMessage()], + ) + + +def test_ContentLengthWriter() -> None: + w = ContentLengthWriter(5) + assert dowrite(w, Data(data=b"123")) == b"123" + assert dowrite(w, Data(data=b"45")) == b"45" + assert dowrite(w, EndOfMessage()) == b"" + + w = ContentLengthWriter(5) + with pytest.raises(LocalProtocolError): + dowrite(w, Data(data=b"123456")) + + w = ContentLengthWriter(5) + dowrite(w, Data(data=b"123")) + with pytest.raises(LocalProtocolError): + dowrite(w, Data(data=b"456")) + + w = ContentLengthWriter(5) + dowrite(w, Data(data=b"123")) + with pytest.raises(LocalProtocolError): + dowrite(w, EndOfMessage()) + + w = ContentLengthWriter(5) + dowrite(w, Data(data=b"123")) == b"123" + dowrite(w, Data(data=b"45")) == b"45" + with pytest.raises(LocalProtocolError): + dowrite(w, EndOfMessage(headers=[("Etag", "asdf")])) + + +def test_ChunkedWriter() -> None: + w = ChunkedWriter() + assert dowrite(w, Data(data=b"aaa")) == b"3\r\naaa\r\n" + assert dowrite(w, Data(data=b"a" * 20)) == b"14\r\n" + b"a" * 20 + b"\r\n" + + assert dowrite(w, Data(data=b"")) == b"" + + assert dowrite(w, EndOfMessage()) == b"0\r\n\r\n" + + assert ( + dowrite(w, EndOfMessage(headers=[("Etag", "asdf"), ("a", "b")])) + == b"0\r\nEtag: asdf\r\na: b\r\n\r\n" + ) + + +def test_Http10Writer() -> None: + w = Http10Writer() + assert dowrite(w, Data(data=b"1234")) == b"1234" + assert dowrite(w, EndOfMessage()) == b"" + + with pytest.raises(LocalProtocolError): + dowrite(w, EndOfMessage(headers=[("Etag", "asdf")])) + + +def test_reject_garbage_after_request_line() -> None: + with pytest.raises(LocalProtocolError): + tr(READERS[SERVER, SEND_RESPONSE], b"HTTP/1.0 200 OK\x00xxxx\r\n\r\n", None) + + +def test_reject_garbage_after_response_line() -> None: + with pytest.raises(LocalProtocolError): + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1 xxxxxx\r\n" b"Host: a\r\n\r\n", + None, + ) + + +def test_reject_garbage_in_header_line() -> None: + with pytest.raises(LocalProtocolError): + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" b"Host: foo\x00bar\r\n\r\n", + None, + ) + + +def test_reject_non_vchar_in_path() -> None: + for bad_char in b"\x00\x20\x7f\xee": + message = bytearray(b"HEAD /") + message.append(bad_char) + message.extend(b" HTTP/1.1\r\nHost: foobar\r\n\r\n") + with pytest.raises(LocalProtocolError): + tr(READERS[CLIENT, IDLE], message, None) + + +# https://github.com/python-hyper/h11/issues/57 +def test_allow_some_garbage_in_cookies() -> None: + tr( + READERS[CLIENT, IDLE], + b"HEAD /foo HTTP/1.1\r\n" + b"Host: foo\r\n" + b"Set-Cookie: ___utmvafIumyLc=kUd\x01UpAt; path=/; Max-Age=900\r\n" + b"\r\n", + Request( + method="HEAD", + target="/foo", + headers=[ + ("Host", "foo"), + ("Set-Cookie", "___utmvafIumyLc=kUd\x01UpAt; path=/; Max-Age=900"), + ], + ), + ) + + +def test_host_comes_first() -> None: + tw( + write_headers, + normalize_and_validate([("foo", "bar"), ("Host", "example.com")]), + b"Host: example.com\r\nfoo: bar\r\n\r\n", + ) diff --git a/.venv/Lib/site-packages/h11/tests/test_receivebuffer.py b/.venv/Lib/site-packages/h11/tests/test_receivebuffer.py new file mode 100644 index 0000000..21a3870 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_receivebuffer.py @@ -0,0 +1,135 @@ +import re +from typing import Tuple + +import pytest + +from .._receivebuffer import ReceiveBuffer + + +def test_receivebuffer() -> None: + b = ReceiveBuffer() + assert not b + assert len(b) == 0 + assert bytes(b) == b"" + + b += b"123" + assert b + assert len(b) == 3 + assert bytes(b) == b"123" + + assert bytes(b) == b"123" + + assert b.maybe_extract_at_most(2) == b"12" + assert b + assert len(b) == 1 + assert bytes(b) == b"3" + + assert bytes(b) == b"3" + + assert b.maybe_extract_at_most(10) == b"3" + assert bytes(b) == b"" + + assert b.maybe_extract_at_most(10) is None + assert not b + + ################################################################ + # maybe_extract_until_next + ################################################################ + + b += b"123\n456\r\n789\r\n" + + assert b.maybe_extract_next_line() == b"123\n456\r\n" + assert bytes(b) == b"789\r\n" + + assert b.maybe_extract_next_line() == b"789\r\n" + assert bytes(b) == b"" + + b += b"12\r" + assert b.maybe_extract_next_line() is None + assert bytes(b) == b"12\r" + + b += b"345\n\r" + assert b.maybe_extract_next_line() is None + assert bytes(b) == b"12\r345\n\r" + + # here we stopped at the middle of b"\r\n" delimiter + + b += b"\n6789aaa123\r\n" + assert b.maybe_extract_next_line() == b"12\r345\n\r\n" + assert b.maybe_extract_next_line() == b"6789aaa123\r\n" + assert b.maybe_extract_next_line() is None + assert bytes(b) == b"" + + ################################################################ + # maybe_extract_lines + ################################################################ + + b += b"123\r\na: b\r\nfoo:bar\r\n\r\ntrailing" + lines = b.maybe_extract_lines() + assert lines == [b"123", b"a: b", b"foo:bar"] + assert bytes(b) == b"trailing" + + assert b.maybe_extract_lines() is None + + b += b"\r\n\r" + assert b.maybe_extract_lines() is None + + assert b.maybe_extract_at_most(100) == b"trailing\r\n\r" + assert not b + + # Empty body case (as happens at the end of chunked encoding if there are + # no trailing headers, e.g.) + b += b"\r\ntrailing" + assert b.maybe_extract_lines() == [] + assert bytes(b) == b"trailing" + + +@pytest.mark.parametrize( + "data", + [ + pytest.param( + ( + b"HTTP/1.1 200 OK\r\n", + b"Content-type: text/plain\r\n", + b"Connection: close\r\n", + b"\r\n", + b"Some body", + ), + id="with_crlf_delimiter", + ), + pytest.param( + ( + b"HTTP/1.1 200 OK\n", + b"Content-type: text/plain\n", + b"Connection: close\n", + b"\n", + b"Some body", + ), + id="with_lf_only_delimiter", + ), + pytest.param( + ( + b"HTTP/1.1 200 OK\n", + b"Content-type: text/plain\r\n", + b"Connection: close\n", + b"\n", + b"Some body", + ), + id="with_mixed_crlf_and_lf", + ), + ], +) +def test_receivebuffer_for_invalid_delimiter(data: Tuple[bytes]) -> None: + b = ReceiveBuffer() + + for line in data: + b += line + + lines = b.maybe_extract_lines() + + assert lines == [ + b"HTTP/1.1 200 OK", + b"Content-type: text/plain", + b"Connection: close", + ] + assert bytes(b) == b"Some body" diff --git a/.venv/Lib/site-packages/h11/tests/test_state.py b/.venv/Lib/site-packages/h11/tests/test_state.py new file mode 100644 index 0000000..bc974e6 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_state.py @@ -0,0 +1,271 @@ +import pytest + +from .._events import ( + ConnectionClosed, + Data, + EndOfMessage, + Event, + InformationalResponse, + Request, + Response, +) +from .._state import ( + _SWITCH_CONNECT, + _SWITCH_UPGRADE, + CLIENT, + CLOSED, + ConnectionState, + DONE, + IDLE, + MIGHT_SWITCH_PROTOCOL, + MUST_CLOSE, + SEND_BODY, + SEND_RESPONSE, + SERVER, + SWITCHED_PROTOCOL, +) +from .._util import LocalProtocolError + + +def test_ConnectionState() -> None: + cs = ConnectionState() + + # Basic event-triggered transitions + + assert cs.states == {CLIENT: IDLE, SERVER: IDLE} + + cs.process_event(CLIENT, Request) + # The SERVER-Request special case: + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + + # Illegal transitions raise an error and nothing happens + with pytest.raises(LocalProtocolError): + cs.process_event(CLIENT, Request) + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + + cs.process_event(SERVER, InformationalResponse) + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + + cs.process_event(SERVER, Response) + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_BODY} + + cs.process_event(CLIENT, EndOfMessage) + cs.process_event(SERVER, EndOfMessage) + assert cs.states == {CLIENT: DONE, SERVER: DONE} + + # State-triggered transition + + cs.process_event(SERVER, ConnectionClosed) + assert cs.states == {CLIENT: MUST_CLOSE, SERVER: CLOSED} + + +def test_ConnectionState_keep_alive() -> None: + # keep_alive = False + cs = ConnectionState() + cs.process_event(CLIENT, Request) + cs.process_keep_alive_disabled() + cs.process_event(CLIENT, EndOfMessage) + assert cs.states == {CLIENT: MUST_CLOSE, SERVER: SEND_RESPONSE} + + cs.process_event(SERVER, Response) + cs.process_event(SERVER, EndOfMessage) + assert cs.states == {CLIENT: MUST_CLOSE, SERVER: MUST_CLOSE} + + +def test_ConnectionState_keep_alive_in_DONE() -> None: + # Check that if keep_alive is disabled when the CLIENT is already in DONE, + # then this is sufficient to immediately trigger the DONE -> MUST_CLOSE + # transition + cs = ConnectionState() + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, EndOfMessage) + assert cs.states[CLIENT] is DONE + cs.process_keep_alive_disabled() + assert cs.states[CLIENT] is MUST_CLOSE + + +def test_ConnectionState_switch_denied() -> None: + for switch_type in (_SWITCH_CONNECT, _SWITCH_UPGRADE): + for deny_early in (True, False): + cs = ConnectionState() + cs.process_client_switch_proposal(switch_type) + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, Data) + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + + assert switch_type in cs.pending_switch_proposals + + if deny_early: + # before client reaches DONE + cs.process_event(SERVER, Response) + assert not cs.pending_switch_proposals + + cs.process_event(CLIENT, EndOfMessage) + + if deny_early: + assert cs.states == {CLIENT: DONE, SERVER: SEND_BODY} + else: + assert cs.states == { + CLIENT: MIGHT_SWITCH_PROTOCOL, + SERVER: SEND_RESPONSE, + } + + cs.process_event(SERVER, InformationalResponse) + assert cs.states == { + CLIENT: MIGHT_SWITCH_PROTOCOL, + SERVER: SEND_RESPONSE, + } + + cs.process_event(SERVER, Response) + assert cs.states == {CLIENT: DONE, SERVER: SEND_BODY} + assert not cs.pending_switch_proposals + + +_response_type_for_switch = { + _SWITCH_UPGRADE: InformationalResponse, + _SWITCH_CONNECT: Response, + None: Response, +} + + +def test_ConnectionState_protocol_switch_accepted() -> None: + for switch_event in [_SWITCH_UPGRADE, _SWITCH_CONNECT]: + cs = ConnectionState() + cs.process_client_switch_proposal(switch_event) + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, Data) + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + + cs.process_event(CLIENT, EndOfMessage) + assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE} + + cs.process_event(SERVER, InformationalResponse) + assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE} + + cs.process_event(SERVER, _response_type_for_switch[switch_event], switch_event) + assert cs.states == {CLIENT: SWITCHED_PROTOCOL, SERVER: SWITCHED_PROTOCOL} + + +def test_ConnectionState_double_protocol_switch() -> None: + # CONNECT + Upgrade is legal! Very silly, but legal. So we support + # it. Because sometimes doing the silly thing is easier than not. + for server_switch in [None, _SWITCH_UPGRADE, _SWITCH_CONNECT]: + cs = ConnectionState() + cs.process_client_switch_proposal(_SWITCH_UPGRADE) + cs.process_client_switch_proposal(_SWITCH_CONNECT) + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, EndOfMessage) + assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE} + cs.process_event( + SERVER, _response_type_for_switch[server_switch], server_switch + ) + if server_switch is None: + assert cs.states == {CLIENT: DONE, SERVER: SEND_BODY} + else: + assert cs.states == {CLIENT: SWITCHED_PROTOCOL, SERVER: SWITCHED_PROTOCOL} + + +def test_ConnectionState_inconsistent_protocol_switch() -> None: + for client_switches, server_switch in [ + ([], _SWITCH_CONNECT), + ([], _SWITCH_UPGRADE), + ([_SWITCH_UPGRADE], _SWITCH_CONNECT), + ([_SWITCH_CONNECT], _SWITCH_UPGRADE), + ]: + cs = ConnectionState() + for client_switch in client_switches: # type: ignore[attr-defined] + cs.process_client_switch_proposal(client_switch) + cs.process_event(CLIENT, Request) + with pytest.raises(LocalProtocolError): + cs.process_event(SERVER, Response, server_switch) + + +def test_ConnectionState_keepalive_protocol_switch_interaction() -> None: + # keep_alive=False + pending_switch_proposals + cs = ConnectionState() + cs.process_client_switch_proposal(_SWITCH_UPGRADE) + cs.process_event(CLIENT, Request) + cs.process_keep_alive_disabled() + cs.process_event(CLIENT, Data) + assert cs.states == {CLIENT: SEND_BODY, SERVER: SEND_RESPONSE} + + # the protocol switch "wins" + cs.process_event(CLIENT, EndOfMessage) + assert cs.states == {CLIENT: MIGHT_SWITCH_PROTOCOL, SERVER: SEND_RESPONSE} + + # but when the server denies the request, keep_alive comes back into play + cs.process_event(SERVER, Response) + assert cs.states == {CLIENT: MUST_CLOSE, SERVER: SEND_BODY} + + +def test_ConnectionState_reuse() -> None: + cs = ConnectionState() + + with pytest.raises(LocalProtocolError): + cs.start_next_cycle() + + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, EndOfMessage) + + with pytest.raises(LocalProtocolError): + cs.start_next_cycle() + + cs.process_event(SERVER, Response) + cs.process_event(SERVER, EndOfMessage) + + cs.start_next_cycle() + assert cs.states == {CLIENT: IDLE, SERVER: IDLE} + + # No keepalive + + cs.process_event(CLIENT, Request) + cs.process_keep_alive_disabled() + cs.process_event(CLIENT, EndOfMessage) + cs.process_event(SERVER, Response) + cs.process_event(SERVER, EndOfMessage) + + with pytest.raises(LocalProtocolError): + cs.start_next_cycle() + + # One side closed + + cs = ConnectionState() + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, EndOfMessage) + cs.process_event(CLIENT, ConnectionClosed) + cs.process_event(SERVER, Response) + cs.process_event(SERVER, EndOfMessage) + + with pytest.raises(LocalProtocolError): + cs.start_next_cycle() + + # Succesful protocol switch + + cs = ConnectionState() + cs.process_client_switch_proposal(_SWITCH_UPGRADE) + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, EndOfMessage) + cs.process_event(SERVER, InformationalResponse, _SWITCH_UPGRADE) + + with pytest.raises(LocalProtocolError): + cs.start_next_cycle() + + # Failed protocol switch + + cs = ConnectionState() + cs.process_client_switch_proposal(_SWITCH_UPGRADE) + cs.process_event(CLIENT, Request) + cs.process_event(CLIENT, EndOfMessage) + cs.process_event(SERVER, Response) + cs.process_event(SERVER, EndOfMessage) + + cs.start_next_cycle() + assert cs.states == {CLIENT: IDLE, SERVER: IDLE} + + +def test_server_request_is_illegal() -> None: + # There used to be a bug in how we handled the Request special case that + # made this allowed... + cs = ConnectionState() + with pytest.raises(LocalProtocolError): + cs.process_event(SERVER, Request) diff --git a/.venv/Lib/site-packages/h11/tests/test_util.py b/.venv/Lib/site-packages/h11/tests/test_util.py new file mode 100644 index 0000000..79bc095 --- /dev/null +++ b/.venv/Lib/site-packages/h11/tests/test_util.py @@ -0,0 +1,112 @@ +import re +import sys +import traceback +from typing import NoReturn + +import pytest + +from .._util import ( + bytesify, + LocalProtocolError, + ProtocolError, + RemoteProtocolError, + Sentinel, + validate, +) + + +def test_ProtocolError() -> None: + with pytest.raises(TypeError): + ProtocolError("abstract base class") + + +def test_LocalProtocolError() -> None: + try: + raise LocalProtocolError("foo") + except LocalProtocolError as e: + assert str(e) == "foo" + assert e.error_status_hint == 400 + + try: + raise LocalProtocolError("foo", error_status_hint=418) + except LocalProtocolError as e: + assert str(e) == "foo" + assert e.error_status_hint == 418 + + def thunk() -> NoReturn: + raise LocalProtocolError("a", error_status_hint=420) + + try: + try: + thunk() + except LocalProtocolError as exc1: + orig_traceback = "".join(traceback.format_tb(sys.exc_info()[2])) + exc1._reraise_as_remote_protocol_error() + except RemoteProtocolError as exc2: + assert type(exc2) is RemoteProtocolError + assert exc2.args == ("a",) + assert exc2.error_status_hint == 420 + new_traceback = "".join(traceback.format_tb(sys.exc_info()[2])) + assert new_traceback.endswith(orig_traceback) + + +def test_validate() -> None: + my_re = re.compile(rb"(?P[0-9]+)\.(?P[0-9]+)") + with pytest.raises(LocalProtocolError): + validate(my_re, b"0.") + + groups = validate(my_re, b"0.1") + assert groups == {"group1": b"0", "group2": b"1"} + + # successful partial matches are an error - must match whole string + with pytest.raises(LocalProtocolError): + validate(my_re, b"0.1xx") + with pytest.raises(LocalProtocolError): + validate(my_re, b"0.1\n") + + +def test_validate_formatting() -> None: + my_re = re.compile(rb"foo") + + with pytest.raises(LocalProtocolError) as excinfo: + validate(my_re, b"", "oops") + assert "oops" in str(excinfo.value) + + with pytest.raises(LocalProtocolError) as excinfo: + validate(my_re, b"", "oops {}") + assert "oops {}" in str(excinfo.value) + + with pytest.raises(LocalProtocolError) as excinfo: + validate(my_re, b"", "oops {} xx", 10) + assert "oops 10 xx" in str(excinfo.value) + + +def test_make_sentinel() -> None: + class S(Sentinel, metaclass=Sentinel): + pass + + assert repr(S) == "S" + assert S == S + assert type(S).__name__ == "S" + assert S in {S} + assert type(S) is S + + class S2(Sentinel, metaclass=Sentinel): + pass + + assert repr(S2) == "S2" + assert S != S2 + assert S not in {S2} + assert type(S) is not type(S2) + + +def test_bytesify() -> None: + assert bytesify(b"123") == b"123" + assert bytesify(bytearray(b"123")) == b"123" + assert bytesify("123") == b"123" + + with pytest.raises(UnicodeEncodeError): + bytesify("\u1234") + + with pytest.raises(TypeError): + bytesify(10) diff --git a/.venv/Lib/site-packages/idna-3.10.dist-info/INSTALLER b/.venv/Lib/site-packages/idna-3.10.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/idna-3.10.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/idna-3.10.dist-info/LICENSE.md b/.venv/Lib/site-packages/idna-3.10.dist-info/LICENSE.md new file mode 100644 index 0000000..19b6b45 --- /dev/null +++ b/.venv/Lib/site-packages/idna-3.10.dist-info/LICENSE.md @@ -0,0 +1,31 @@ +BSD 3-Clause License + +Copyright (c) 2013-2024, 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/.venv/Lib/site-packages/idna-3.10.dist-info/METADATA b/.venv/Lib/site-packages/idna-3.10.dist-info/METADATA new file mode 100644 index 0000000..c42623e --- /dev/null +++ b/.venv/Lib/site-packages/idna-3.10.dist-info/METADATA @@ -0,0 +1,250 @@ +Metadata-Version: 2.1 +Name: idna +Version: 3.10 +Summary: Internationalized Domain Names in Applications (IDNA) +Author-email: Kim Davies +Requires-Python: >=3.6 +Description-Content-Type: text/x-rst +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +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 :: Only +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: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Internet :: Name Service (DNS) +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: Utilities +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 the Internationalized Domain Names in +Applications (IDNA) protocol as specified in `RFC 5891 +`_. This is the latest version of +the protocol and is sometimes referred to as “IDNA 2008”. + +This library also provides support for Unicode Technical +Standard 46, `Unicode IDNA Compatibility Processing +`_. + +This acts as a suitable replacement for the “encodings.idna” +module that comes with the Python standard library, but which +only supports the older superseded IDNA specification (`RFC 3490 +`_). + +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: + +.. 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 A-labels or U-labels +respectively. + +.. code-block:: pycon + + >>> import idna + >>> idna.encode('ドメイン.テスト') + b'xn--eckwd4c7c.xn--zckzah' + >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah')) + ドメイン.テスト + +You may use the codec encoding and decoding methods using the +``idna.codec`` module: + +.. code-block:: pycon + + >>> import idna.codec + >>> print('домен.испытание'.encode('idna2008')) + b'xn--d1acufc.xn--80akhbyknj4f' + >>> print(b'xn--d1acufc.xn--80akhbyknj4f'.decode('idna2008')) + домен.испытание + +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) ++++++++++++++++++++++++++++++++ + +As described in `RFC 5895 `_, the +IDNA specification does not normalize input from different potential +ways a user may input a domain name. This functionality, known as +a “mapping”, is considered by the specification to be a local +user-interface issue distinct from IDNA conversion functionality. + +This library provides one such mapping that was developed by the +Unicode Consortium. Known as `Unicode IDNA Compatibility Processing +`_, it provides for both a regular +mapping for typical applications, as well as a transitional mapping to +help migrate from older IDNA 2003 applications. Strings are +preprocessed according to Section 4.4 “Preprocessing for IDNA2008” +prior to the IDNA operations. + +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 + +Transitional processing provides conversions to help transition from +the older 2003 standard to the current standard. For example, in the +original IDNA specification, the *LATIN SMALL LETTER SHARP S* (ß) was +converted into two *LATIN SMALL LETTER S* (ss), whereas in the current +IDNA specification this conversion is not performed. + +.. code-block:: pycon + + >>> idna.encode('Königsgäßchen', uts46=True, transitional=True) + 'xn--knigsgsschen-lcb0w' + +Implementers should use transitional processing with caution, only in +rare cases where conversion from legacy labels to current labels must be +performed (i.e. IDNA implementations that pre-date 2008). For typical +applications that just need to convert labels, transitional processing +is unlikely to be beneficial and could produce unexpected incompatible +results. + +``encodings.idna`` Compatibility +++++++++++++++++++++++++++++++++ + +Function calls from the Python built-in ``encodings.idna`` module are +mapped to their IDNA 2008 equivalents using the ``idna.compat`` module. +Simply substitute the ``import`` clause in your code to refer to the new +module name. + +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 positional context (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. These tables are +computed 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.6 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. + Removing support for older versions should be well justified in that the + maintenance burden has become too high. + +* **Python 2**. Python 2 is supported by version 2.x of this library. + Use "idna<3" in your requirements file if you need this library for + a Python 2 application. Be advised that these versions are no longer + actively developed. + +* **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. + diff --git a/.venv/Lib/site-packages/idna-3.10.dist-info/RECORD b/.venv/Lib/site-packages/idna-3.10.dist-info/RECORD new file mode 100644 index 0000000..54f6609 --- /dev/null +++ b/.venv/Lib/site-packages/idna-3.10.dist-info/RECORD @@ -0,0 +1,22 @@ +idna-3.10.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +idna-3.10.dist-info/LICENSE.md,sha256=pZ8LDvNjWHQQmkRhykT_enDVBpboFHZ7-vch1Mmw2w8,1541 +idna-3.10.dist-info/METADATA,sha256=URR5ZyDfQ1PCEGhkYoojqfi2Ra0tau2--lhwG4XSfjI,10158 +idna-3.10.dist-info/RECORD,, +idna-3.10.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81 +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=PEew3ItwzjW4hymbasnty2N2OXvNcgHB-JjrBuxHPYY,3422 +idna/compat.py,sha256=RzLy6QQCdl9784aFhb2EX9EKGCJjg0P3PilGdeXXcx8,316 +idna/core.py,sha256=YJYyAMnwiQEPjVC4-Fqu_p4CJ6yKKuDGmppBNQNQpFs,13239 +idna/idnadata.py,sha256=W30GcIGvtOWYwAjZj4ZjuouUutC6ffgNuyjJy7fZ-lo,78306 +idna/intranges.py,sha256=amUtkdhYcQG8Zr-CoMM_kVRacxkivC1WgxN1b63KKdU,1898 +idna/package_data.py,sha256=q59S3OXsc5VI8j6vSD0sGBMyk6zZ4vWFREE88yCJYKs,21 +idna/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +idna/uts46data.py,sha256=rt90K9J40gUSwppDPCrhjgi5AA6pWM65dEGRSf6rIhM,239289 diff --git a/.venv/Lib/site-packages/idna-3.10.dist-info/WHEEL b/.venv/Lib/site-packages/idna-3.10.dist-info/WHEEL new file mode 100644 index 0000000..3b5e64b --- /dev/null +++ b/.venv/Lib/site-packages/idna-3.10.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/.venv/Lib/site-packages/idna/__init__.py b/.venv/Lib/site-packages/idna/__init__.py new file mode 100644 index 0000000..cfdc030 --- /dev/null +++ b/.venv/Lib/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/.venv/Lib/site-packages/idna/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/idna/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..86a7b4d2100664174c08642d5f5e3941dbd55a04 GIT binary patch literal 900 zcmbu7J&)5c7{~3jO<&UY_IeD64T%mt7!VQ&A;H0L5;|^Su_9S+Vp3o8*pZV~bmUX8 zv+-H@29|DOVnZD0Bqr>nFdPyK9)5YAf9&VQk3aQ#9c0({R~JcKL+G<}elKrtTo%@N zk75+#6agj}JmNu()Syo4&>#))i4RTEgcfN*o3x=rIuMWmx}*y|(t|$f!+;E6NQN*X zBN&r0cJaJ)0#h;9CWpJm-2Z}Y>iO98PM)7WeI{b@LTjZ>+qsoF zJdsl+LGmW-m?KX(C;BXgK%| zO^234+rf=q2M%3_o8`Qu(CziCBv~JljPprr}Jha~>6WnCV5r?L1kb zbeO6n50{pdWf_Id`r*CsXv^g`d?}V;E(*Tbr_4hUOLmu1_bw7&-6@X{S-R1H}A}Q*}`mrs^j$|U0;@WlM%1#i+bW$*~9h}ALdg+Sm20aSNNoua)cczDJ-R&VQ0z}cBR~5H%Dwlp7DZP?0;%QAzn!;<@Oj3P_;~5l8=gH8_u@jW0sVT}y zc}`85qM}CAifW3gX60F?&wAjEA5VV%&bwd!_tH~JcL{l#a9XmffJp6U+_|)t=9lbIar%YuhZz@)Vv+}MpN5buz(+h4fwiF@b0uEEuz z=hufqrJ>NR^J_!XYh9;TJ*WTW4U_}@54=4E<-PnzXRmdC_@hYAnitxOHMqcO9}47CeIDpQy{I(nAD}IYZS=dt9^D6YKvC!baZeG@zVN6u8{< zmq9F%uWSxsym)YfKz7~EvX2kl>bY&dHBdS-T|xC%U1)O1GTCF9oV#@pOb-7!Qbh}^ z4fGs^el=5Pt&ediU#K0ZMQeLVfsh)Er@1R27p-2lb z0pQDF;6$`pTXpXr=S*`GQQQG+B|Q8$ zqzVFflF^Rhqy!~~Jhrt=UnHx=kvI`0ZRioInu4B5#tk@;G8t7` zisRXwe>#qJB0HvZ(_>IMj-W+%cuwfqqyZp}FMwm~i1S#=2-_q&u1sKREwSBUc1Gs1 zv6xCD7W5WIwywX)%_h6Si(Ufpq+Ilmtoz4H{_*Slntx(hEcXp8d+xaXfXw3Pucykp z_Y^$k?t$WgtEcYt4BW?3;nbZ#e|gV%Vfwy50B?AG%lzG*!Q~TWPuG>xmrs8*cCF{b ziBCQI?f`jx-9_%Iv%r@*L5>>Vt=w(1>Ol}6Y!&IFwlVNrzF4fH3*FbUMkHLoslo zdr%xgu@?oB-r^00N)!cp(I-GGkqz4}Ve}gC2C_c_Zy@_P#IjrGZXa5G_1x{L(uwm` z)LWkL{ck`O9-U{B zT2y6goIZ{3U|3FZ*-{*9D-^(^?9nu$&!7>8=@d{-=m8W5L71)@d*GR*6(GV%;O@b(w?{?7iXckjJGZ^0m>4SPFH+xqt+c%Ud0_*d{-mPnbGtcFqlO&fkyl@(~1;%aFhj1cNjT*Sgl zC>Xd=W%3wYS{$r@AE*gNCOG1iKY&;vdARzs%NCa-&Ffa8#xO8xq&#U}s&3Y_i3ar= zW{98o- z?20#IP3!oln{?K$qoxP8FwE#%Y)0!(pn+kAcwJ<7DBX0j%hO2>E_VpfW;^UKWJ{3E zGaG*h_pviN4)m}UiFkEYrqPR$SXPVT6`syOT@sCOCSl7v+{+7}IQq-pz&*Er-91=x z50*Rp_q^Tjy>;d7%WpRegA@1Q*E0gYs#o%e8$=RBHqpU;It|WD8^m6sk;_2vMA>fQ zL2F$o_-LA{79?3X#_mHn_6&!nBbrWS;z`wFC4Q(m@DhulRAp=E#6JCz1~tO94U4s_ zPh)HN^`=DC`M3`IsBIye(oySX^a4E(b~uXqpFnKbIgYzaI_?tZKgoEBjDJCnd`6Dk z59}-)Sed#ywYqC+EpTL&_^P6x8(;pxmFdgVRRYE8zTMntv3I?Hs?| zU_8vTVE7z^L&6B7F-d5fCY5%D5>{bGY$RseOsuwr*yJ{|cy-rg_B*p(LtNoiUf-?E z;CW57JQY8V>^lJ%`h14v9MFUXzb!@g_N@o=c&MJB}&T&`C`>zq_js{B6lW`a#4X zlKw^>z6c=M0P&KCO8ObhcX`SoPy+l|bfw=xyAx#DPSV@EzvwUQ^K{=|i#ooH6raz6 za4+a`=|?OLZigbt0=1CkMRiN8Y_7IiZ~^n$IENEx-jHw2%Lg~#KkS>+L&W6&JA)=3 z!`}3rpzj=Y29p>T^(}$2Y6am6V*T!LQJYJerPBMie2k8jd`sPm_iC>7*jsV#EH2)2 znBdY$g>rf-iX+LLG)Q;`JaaM-N`xYIX))yq)k?CMCp=Z0JpmAaB~M`ye^*-@pM`74 zXrZJwC{km#e`D=yW4&*#m!-QCg{|@|O1q$+9`v^@%uoOy>7XCFFrg0;cQuU&) z;{YJYOEtYViGfuYwtdSsrKzU<)-|9{Ut literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/idna/__pycache__/core.cpython-312.pyc b/.venv/Lib/site-packages/idna/__pycache__/core.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..68f82888e07e2c01e929206ebe9e97a67b2331e3 GIT binary patch literal 16135 zcmd6OTWlOxc3@S%-%q|DV)G$VEs1(jl0EW6q9{@?in2w@Bhj+k&8{NZRI{6^DoP@! z8PkffOL>I2WhYR3Eo^!+N|uUeca_W_@gND{#6d9FnU88VJ#3X3tb$QK1T2u&kPCPn zYB(EFPL9C1E#|?vqapRzorWieAh?&OCgJzO8#w_F3K`W$9gEq!I zXxC9JJyxX-Qj8hPN3@(9bn2+16k~mxVr;DIBfV1UCZ%>Lb+B%&)I&<0Q0giv^^#II zlzK`^eTQ_5T~|}fRw!`mptg?L4fW+ry;i#EZR21)DZ|kXOarvqRFV%s zzCq42G}JdjK0xwK1S7<_8Oj8gl{ zHyRhXaD0U2Ly<&W2uI_Otk8-#KyWqQ-ahGo#H%}gF?;P_{`&X+6P1bfT(?HAE2C^YFa$Lm;7?W+h;?Zavg2%A z-~(Zf4a5^dfDa2%emKf9eViRpz?G4a@nNb=4KSf$+^u1Z#oq{H&++)>a4gDnB^Y)h z0lR7X`E^K#15A{MrA}Odg@sk0gdG`6M94bBvdg^!Q9dxqe-+jhh&2W^rC9f9SYy>U z!n$%j)?Kjq*{i~I*E-~dQ8us!Nu)8Ea3C5F$hD+rAS!(Q98i*T7zE&_QT~)R2dt8G zkqODfvBD%5kEqNA<&+VAdibsUM+k0Ff>t*MN6z|Bz}DnTQtDBm#xr!1X6TDs0GD71 z6qDMc7=IlU-Y%e&ARnVsVP6B-{Zvrj$01VFfwS?8@x+yQ068xl5m*jMHW`m1J&E`+ zO7@bhWQ`=ohoW(i1Cl;6%1H)fZprpaI5x==ehBI~6wVTTna2?V0S@=Hujptu!&{2>Ttsb!0Q$x@%S)ZdO|nm!!KSz2d1^JdFj=e5hr?wTccL)P7JN1r+T zeeI>Bn%a(3Hy4(!@{ZU(V}gJ(P}aNBXv5}b^oNnmYm7ZmTu zD!+nH`I5aZYp+YcT!N8gjD?5T*v5$A-YeY;MPz{QjsV}$Q@SaA(9rkjAhhfmxJyg= z7#jyN?Z$CSQ1THu6Cz`Upvj0Z$~^;Z4q!VOzh$#+Zr|@trw(6xGw&|T+uia~I^ax? z#(2;KsH7*Npo<5$7x2VpsSxU1dV-<{tbFO`ri=r3~+lPf?bFhbI(Gs zW*7Qpym^5`3>3tlhgOHMCCWM2jxypO^xo{Bk1Uw?lwxm^14E|Wud`{z6~H-39fpegDKuzg0bya#aP8tjjzGUFk@z@8OvAFHT7%J)x;eI zeC?NMuBHS}$3}Pp6_pvQF`=SUnYlS`21u@pzy`QUXE5g`6z)q}fU?FJ%Z>h|C27PK zK=<<{<9XIV^sd9k_YJV|tJvJQu3`gYy^HwVcn{Xt4CiBU2bC4aoiYW>`+7J$HzaC$ zw|YR9D0NX`3QtMG^MUWo1j0gKA^{pGXnc?bm6|>y={kGi*Ec|pS>VD$0FLWKm~`*- z3q4Ve7fN-O5@_R-P&LGYLZ)evIAHJgz!}ucI(vh*A~fzWg4A{Q!LMJ^b-}NDK+>It z{NX-H-`9U?`lzBt6#){xzNj#*MIUDt4sg+tQK4N(w8z+CL7pibb=o92kdYJ_n*%OJ zDT8>B(&;^2;W*K9$D>yR@yT(}-(vw`YJ%mz8nlJ$Qu}k=nCijcCYX>m2>sK~e9up)6pc)Ct|1q%XEcL)!F?(X!Uza|c>HN9B^}2aZKX+!itYN9FJzLg3 zKa?xmJ!j3^%hI}c4nFiXh=Km4z+g5oxcF*Fe1pxsIxLP}%mrdO-?-=)hjwCBaKRqT zSJz)ZQE*aaZI4})qvC^T-tAvCQQo>GPcZ8V&Tqa)-`$e)bj%*ln?0$MS#v|)<-4xW zTYag>g0(vD@?Y0Kbk&M=uP)UMW$T6(BO~JIcrFsp)g^MS3DGj~z+W}nn{V7ad-7?> z|C8PIz+F|K?2WF+l-=W6t)ePh#Fp`;79rarh?7@yEmOIQY0)zc&BVHnth*!M(0tR8 z_tvD@1#fe{p(W*js&wyyd&~XGrhL=3nGj~ zm$L4cmMfaSYJ~L3th=o^K#mM>(@{7@Beh8-oxH$COI|%W>zR$qo4Ns9d6|;af7- zX3e$f?o8tc$8zS)nQ+#;Wxi{{ymQ%ADOR1xxlW3fldAT#hE_-?LaR3*fm$#FdQlD7 z?v(i}Q~~>zrbxhnMKMNVMKWP4-U4}Ym@^~~R4ew7WdPh<;)q5W<{*(jK^9 zmPp}%3~(Sw%NC9Ggm%k>mRp4q7rEB~zxUwBcR~PKyV)`K^4z7_>D0i2xth>a*?*+w zt*fbyYj37EXLKI~GyFo$R??y?=Q<)odb*}Jmrw-`L^zoG@Lmv$PJ{gf&e|Tx1-jIYXpJkC?8XFAG}icVgc|~k{{xZ+ zR$kqFby+h?$nKnZ>pZ()?jZ9&m~$NxEr$wv%CcA1+V!x2YcyWeA;{+YQ`i-yWJprV zeNov+GrA;bL%7*eH0OgGzO1@86?M$wmczb`e%eM+rTV3+qZDtcWP<}MGsYQxQJYcw zGA72PnwF1Hubl^7+aOo~U-FFs^!4AEY9=qKSc8>eBYaTrEw*CJDxNZSH(pp%t1(ka z53AZ^SO;30ficYJX)2CC8Z7Il1eo574<{r_UdHg$GiIb)+d zn%Exkr=6EGl+8x?2LG|Bnpe9A7KSo_i1BSITEm;uMQ1l0c_{P-bYF*rlqzSO?7 z|K@@3zBzmBf!UqfpEFnI?XHyfooAMb@u+*g8MKnN@Ac&Z9Xa>j#b-}1xKHORYacj$ zbGl`3MT$?qeDg|1mpS}%Z`)kwa&7Zc?e1*t?xos&+1hJBIm8b*P zegsx73qY&(JP<*#r+%85?f0H02K7m}4wG$tgwZAGi0-QHBJ|Wl8k}CE`OpOU|K4?ly)Fmrc8j5ne^I|q@RLCVB>mXh4B?NEd@7aOn41M zHiNGpW&ooRvjA^|l#PsAr7`%EFqA`pv9E*SAU*dcDG+pEL!2=r4UChN(KoCmm>3wB z+LNzdQ|{KvoomWHS~-1V2hiMT0IV5rQcutU1Y{G-1F+80ILqZnid zdZLrCgC*lpj%6=KS6~N6S0Rv0$Jil`y%PP`T@-~as9*f4VCfFXr4$nc)TZ_86$lw z|HM7-AN4K!>(gweYrgS&M?Z+qkL3LOMaTY(QM58PV}fN$byj zm2-zdJf+UP^E)6!m)+Irru5jNJNSdak98lPSZqJ~vjgHQ=fuI#XD8pdUs+qQQvRxf z4W!Wnt1Go-(b}A5KeIL~V9IXm(}zEV2ZCT`f6g7eUs?B9PkFY241`V~!eDx8C+Jyl zP!8{k9qJH;r}wpco-}o%jS;uVN(REU+Ml4XJZLGXDwA(mvww14FxG4KC$%1~D4MZ; zhAO__ln6xiQm0urOD}bTroRLz=P>R-k@~vr$HtThzM?hnJtz5AxqD2?dN*hga z2kop&aK7Ac%abnG#ynnih)N1N*SJlP$j;Y_3pO_2;Q8H0Zq3 z#z|qg{aJDpOxwH1C(yEr#y`pQ(kq?4$B#&suG4)3-RA~QOm95_Dl9yRf`u3FTr?YonXzyL-u?qZB7nNB3~nP3+Q6s3Z12)u+<%3!r`I-L2Rkvm z4*y`KWQ+1(Kn~wCibDqs}M)d*iC{xmra_>qCQcj$JgAEgSr)?nOh*vY{ruZ_&{B5G|!k{$|Ba>aR#~?>{qVfw$T8 zxjR>v+B&msou6#Uww+wG_vRgC%g#;dt3Rk(3U+0KU7wuD22U?KUn=NqPTz9n<_tUE zzgW3@xn_61>c~>n$!yihpLL6827h{5eC-V}!en1#7Kg{gixauwOSvj;MX#%^C{Vic z3OKT=_NyOJygrWhZ{NPkj0OPY;S0LgG*)dm*yO zM#Zs2j-AMrT>`k3K7i}>ty(C5bKY}s$>;^AVbV4!UZ2EeZa z%JE4^%u)rN+33ty)ZU8SjAfq5RcxEHFI!x5-&wTOF1s5u+ZNqBmVIE;-k$Tdi;niZ zyGFFse6eh=|0P8mo%bz{f*#^8;f28HNf{Rn70bTBoo~&b%{6yqeI2tWAKL5F7Z>fa z*>OwG6%;MO2lfilP{E^(=UT^p>MyLFI{n|$G=yt54U(8_8XcUj-$V!F{bYlEy%t8t zbxByrB)ySs>?0T&KT@yRqU16R1&^9mHzC&vS4>UEda|AY_bG%1n^n`Y)_U)ZX?m6l zyHsmrWYD3#jV{^F8gqc%iT--X{m70Rw=t=(L1)!Y^HNqx!o_zTi+M^< z{vD4#;K2pHDd1?wNj5lyIf2I~NA5aS?!y4>vfMRn=1@5sy)(IYps18p zxqpuhG1!TG3Ni~1LVJ0Nz0KY^FV^o|wC^hD4Di-g)9{DeKiHnRlB?Ny{UqF;D(mL# z4}A4YzUHj2Ip>2HwmiPS)Mw50x8sZE_IyR-o#s37T+=?W=^3%&**W`tcMW0h{+w?> zbPVL}6-)N|Eb#0|&fc2gvi7auA!6T6+8oOHIz>n4LyJFka?uh1QLyB0%z}_;%el9T zmaPSY-ncFAsa^6kWj#%q13Ax*Ib%^U-Y-_$DNoZcDV?=?*-@D`E;=@W+3cO( zf)Psob+r|q&`_{!BUbug&PCvYgxU5bkJo{;x64WW-A->;koweF(bcN|bTf@%u)OO< zJ!m+Iad4tV@-rPF4t!O43B7UR@*93Qw#KrB8=8n0iij6{TZ&QR;I@Ju;iaxC#Z3$r zi$74VOU4;f$r(^&6f-cBK4}Ik6hP&4Nprl!?P5$ji(qW!Bdv|a3nW9U&jT}-q(y%5 zo3Vo9iLHbMHDkMC-!ei=3+h)hwxm_DLU|x1TcO~Ag0n(SHagot2w9T0SyR%GG)=?B za>fwfnzX%D4K0Z6iFavj!H&n7H8>W4gS~7@FE`XU$(xU@ctKS~CtRa$!F53sY8!gf zyTJtr=!72;B-+WVTp={k%ecn0YpvWK!=k`VY61hCLTGZ;(}YQJ{hqw)X~M-befSL9 zJ|3Qs{Yq7@N%GEzo~E)xRUjMz_haHM4T}HSf&RVw(Oo*i@}PN->>$?#@N=_H3jE&v z=w`{GpV=d@{)7E}uH*OFDiGGC}CUFP%3W<+%zk`);KmcL}wi#7a$R*QIln2*i z$u7s>*EKAg-6h-cIKy5g9-6Y+y-q1d9|kUrK<(U3Oykob_dW(VhGa@i3KNsy?S&Zw zdW%XnR5wDzpIEYxnQ)0K;DafIg-KqrgWE$4?moox8F`2px#U36=SiOsI7f#kxIcy# zy(q@^5;6AAhL#6T_iWF@@=fW>KQC{+ZUv`>f#ve5blLmo=WGRCxz&}g49rh|+_kXt z;P-0&{*|TfZ)dx|EuIUDOkAAc#fXsWo)oW6WxJ=cmD6*_^5ykl%X)RLCm(E|JBe=v z&wh6%Loc`+^P5^Tmp-_dvOn-tq?_M!=F4i*k@rsB-L59Keq1Yls~2lqZn|!o^4>bp zyCp9-&a}>V{ZadmZ9g%IXU_gNXLfKH+ilBwHe{SDonNflDNoHWDZSOT>}x93&j)iy!TR-@_(nK87$!av@mwU4 z^GuW|=z8cTE7pH<*wCfZeX4t|>jfjO1Q&(P09RhvWf4si1xjlw)4u_=ze;6NIgWRN zkp*`o`S5jJt(k!*D$ZGIrUEHtP`PIY<)d+gnlXWN@PQ_eyI|c{e373q$IFWv^+s)r z{0S~)W{@yu#yBFsB$T>xX)+cxd$aPUZzOhcBj#VA7z;dDnn6Zy1DR$i(cLv^3G<== zW79^mq=*GrubYaGu8j7Gc?};ejbPy0us@?c2g3PbAJbI9B4Lu+3_zVKkxogYO7}H4 z8HcKTp-%&mj(CeApQ0{l3T~+)sYx`aqAnffM-!7V__q#l&JKiCA8=Kmffz&aHar<8 z|Je|Lf65pIV}>vaZX)3TUL%y2J9;E~2N7pqI%NBbeA*JdYT!%7<|5x=P*ktL4y1NW zyN{4F8SEs=b;nLrC`k{SSi9jIA(jbQh!HIbrG{kWCt^_nJj@k8b@Zp@L9CD~jAVj; z7Xh_RGNAc|dmcJ~FV+@_xIe+*KVeXmb`)5mOL>{@K5?&$x0n;B6y|- z!37E}=wGYo43!Gs_AlD&3p%}ZgkA;Q z%bT5ZLvKx|&McTK^A2BX&)f;Hqw zileAo#P9x#)qO-yqj92m|6_B$VbL)Rw>>ENl1G+*&(YOJecD#u^}If!ZA~cGgwQ__ zAp}AOw*vW+RMC2_ZF*W{#OjhrRUEu_2&?PRb(SxMmFYth{2CA*bM>sZyr?#Aqoh&W0BwwkbnONGy*$^ z!(iNt&rprG`xo7fU&XwWIY;{%=Cym5*YN9g(}N;2e5mJT$@iY zZe6n3nOK+K!m_t9KwFl)aqz&9<@Pm9p?QWp>d6|Z<$3vE7hmN58Y)m4@ps|c0raBj z&nf5Ul=XAU_ur|ef2Jz_k=pX0rdFgX^WLgiSKeQr+H>o`%>&}513CY5BIQ{%fdouB zRw;;99hg2|lAbE2(@~NxIE=J2?JrOeW&A4`6+AS3h)#7BD2y|DIi5GHkbJ>H(}5Ip zfGAy#WdTw&*H4O4{YsIZ_P~2>_k2g@M0V580^sAhcVq>l0-)tdPiD@}cVz~%4ZBF) zCk7Jzq>MCq?C7FtPbyNNFwQV?d{0;*`9iM_AY__JkNFk_s1bky&Jbnx;ygSBkB;u7 zQ-Bx7>46mz7i>YgJPmyz%5;%v9`J(P<8yQy?ZqmHunMAkM@aMubcS4EfNr5HQj_U^ zFoai&^?S0FFd`Iv48(z`&_{dd$`n9=D7|?Fqe5#94Q~W#JvjLt7pvN{z8wV$itcr+ zVD$Jv1HCJ)FHjK8myzfb7!z{h*>fux7mk7ZZgt*QnXjzNS8sZ3Z=s#&I@u3Et3_v1 z*4$jsL)im|r(lE_9-JX%#*~HfmKUs;vQhrZ0``Q*XOn%!iK#P1xR0#?y6y>}P)2}4 VtN_K73=~r~%4A)&LyBzW{|kzf73}~3 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/idna/__pycache__/idnadata.cpython-312.pyc b/.venv/Lib/site-packages/idna/__pycache__/idnadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..61891482f35aef0a6e12d98bd85562e83c9d9909 GIT binary patch literal 99490 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/idna/__pycache__/package_data.cpython-312.pyc b/.venv/Lib/site-packages/idna/__pycache__/package_data.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b7caf5f8a83d690a515fe6cb48f86c48ba4df7ea GIT binary patch literal 231 zcmX@j%ge<81Yi8`ri%jU#~=<2FhUuhIe?7m3@Hpz43&(UOjRt#dWHsmnvA!&@PcM#10+R8G1qJcBrP-DSF?waGd1Wy^nMpClnI);Z1&PVoiRr1uF_|fO yiTY4pd`e6M8Jy1 zMoUwl`c&*bzx|&%Gk5Rpw^%E<9(gmr|IC>=b7uCQnN#jN=bwLW9R2t6<6m^&zAPc` z1S0Ogv%|no%`T6Nn-P~7ml)qWu1|d1_&$-gkv<7+6XN5}iA#*MEtQziHNI;?*GSjW zUCVTfTus?*m|_WtS!P3trBX|^J*z}HN>h%rOO&GwVsvDaSP>%5fFtxVA(& zuBIHQat-OO&G?<)~kx9QRO;`%0AKUdqv+L^u&ml%pZ#c(6n{ z?x!3Nl_>CG%8V!hbYG*CCc$I<#@D2IT}%p#wE(}2<2!}q8yJ>j;1Bb z(U@{HD^ZRnl;g1yv6v@TJOmXzb^66I(`Iod?xx;{hy&RQLA8c_Ib7amTG;^(ON zxhj61ikDUK^Hux;6~9o$FH-S~Rs0eazf{F9Q}N4H{0bGnQpK-Q@vBw*8Wq1*#jjKG z>s9;)6~9r%%c=NHDt@zy-=gBTs`zaxe!Gg_q2lFLyn>2XRPj4i{4N#0Tg5A>cx4r@ zqT*FmyqbzvSMeGuUQ@+usd#M_ucP91RlJ^x-=pI9s(5`BzfZ**sCYvazhA{4Q1J&< z{2>*8Sj8Ku_#-O*sERjM@g^$XRK=UA_+u*GT*V((@fIrngo;0@;!mk~OBHXW;;mKu zX%%n7JAySOe0&L(? z7}SN4*@a87aA_7U!@_5=Fb?PPp2NbZi{t09a9I{UpM@`A;R{*#A{M@wg)d>@OIi3b z7N#9)UxzDL_(~SOiiNQm?dp6D3t!8^*Rk;REPMkC-^jw{SokIuzL|w@Vc}a@_%;^4 zorUjU;qok8frTrw@SQAt7YpA_;k@|P)Eg>+)}lWYuFO(YVZ15}S7YJoEL?+yYqBs7 z?T%lYh3l|zT^6o~aM)AtVc~mOxIPQt$HEO*xSD_MH4Cda4g!DqK#tFZWMha7VS>aM`O_*6m1-fMk(4P7VSw<)F7-zFN!vc zMSD~9u~@VZMVrT>eJT2QEZUEvEn?CB6n!EVeV(FE#-ag5pNd5XP_$(%I*_8RV$neq zZ5@jars&hL=n#swiA9G}^qE+67)9I0qQj|gJ&R~~UE8tnb1dARg*&itM;7jcaM)iv zvv3y|UKtl;Q1~bM7xzcc2kW(KHK1!Spk1eEVh|nBuEnq}Jvs$_S_J)icI`57K)e3I z-QBzP?HY6%*e__;yI=PK?K;!n4xRe<@6cyZuew#*RT|v2@8EXLqMh3fhz{&}cmGaZ zdUfjFbwImlV&6`c2MruhqgG<4ft@P#AC_09!+@^cJ5&kAP{FWuKf$mi#r+uR8eg`| z4{=@NOP2{o5kgJ^4P!=A>!dNo6c6b5duqVC9!Y{G#%Pjl~3nx)H zFTM@+#}S~b=?{gISvZA-Q&~8Tg-5b*It!!Uxntr=yYOfhM(=QZEDMig;qfdyfrTfs z@FW(V%)(Pxcq$7|W8vv6JcEU2vhXYxp3TB@Sa>cA&tu{FEWE&n6N)nt#+A#9FGtP3 z5YccbFJj@vEWCt;m$L9O7GCbd3B@ZAMiGNBs>&V6pmJ6+eHFq@@uwO6ArW1`RbmYb zucdHad}B(n&eMeA^$6qer|jWVN#Ef0NO6`AClqf)7)9m9S0j6v?V`5tCKPW1V86N>ke zWLnyu?+Pk?pF}GO?U!g3p?4%&P3V9`YY4q7(ON`dFeZ)Xk0ng&pG)DQ}}3pGvfyP@Y6P2z@5ePC}ncltbtX ziFOhCQleZ!UlGcSe<&|9U;tI`C=!_JMT(EH@NpJC!NMn5IG=?JSh$ddi&(grg}-Lu zZ&>(S7XA+lf5*b#v+xfr{9hLSk%fO^;h$Of6bt{t!oRZcZ!G*f3;)5wf3omjEc`bM z|Br?L@!^ExI2w6o> zmhvc)&tdYpQXWI{c}y-V<#8mR&*TfFJb~m3nS7CyCy{(HlP{6-6p}Ax@?}zq>bC$@Q3gkCbV~61|tn^`)Fk@_kHh;ANaj@7K3db?^5K=Habm%JKlq@}QJy z1{QsY$q!3;B*~4K{D_okdKi6_$&I~?`s~l4)poRrW2T3_1)I>6WohPQ)4FfLCOpRE z=2C`Dc$~>Cqzs$z1e2e1vMn1n;VCA!bh0fQHlY=h(Me;L^exzgr{g~We%2^~o&*VVL*(48O@<1tLBoAWpU@2oH4`K39 zC)+veZtB~^9I_nCXR5T>Dl|HP-T)G zGL_i_$DhJ-q)Hi%KaI&Fooo*{l@6HhkUbymzbjmSWq8Wt7IAjkpmJTwO z9b~+d%|YItM>!@4v~L!ni4x5rG|3@*+{tv@$w1*OXo{0<jj9J255}^ckvEzu zi^5==#%eNM%CxSD&X9;!Khc>E+0%hBnZ*t=*U9#DXsHsNC(%aAF`wmFAZ1!=L^B<- zWx!}GWH}Z|8RxN>$xEaRqp_69%baX#xIc-?Tkeo8Zw2L8!E&s0vdw}1x{AqboNRN$ zP^@M0Iw#xQ8C2eShir}wlw$+Sk>zBYV>IR1DA5=~*$&x*Y@&l~Vh7nQWm>L9w=j9D zlWiH3>44iDvIpEwIkvMLIa1z5@-8O7>1BA-#J6ZU7Jb{Xyhv|MQ1-{-eGz}x#Z8HC zkEcT(1PX`7At_HJ`7o2;lQIU@`%L~o%2P@HkjWoOc{<4-Gx>;=XOjF0lRuU6Y?AYs z{F#*JlKeT7zmzh3=2uKUDrI#4V@y6SWpw`&Og<@PbpL!N7f2aCvyjO}QijhgX7blk zhR^(l$=^yDL*YM6{!Ys9ncp+{zfR7JBo3$U@w1ED?g1}&iY5O=$a|(yj$b8$=le~d zx6!MAX9xL1$~#H^lgWQc8J+%bCjU>$yGj0s$@KIKo0sh!L2^8hTL4QLb|rzyrKAi$ zSenUYq>RPESxi1#%4Pw~EIC*(czsqCAWe6y2JQ6O$F48ko;zSYTQ8102YxQ)rTOBn{?4knkEvRPO&xuTR| z5bk91T~dZYxSPq9qzr>lnaNe8j7fA=CRdX(CehWIT+hq!NXN5iGdX&XXB3FrYgVx= zOMM~lnN2zF^T-}$8I{t2Wx3z$6o}hrRvn`)G?k zy3wJay-kztL0=0tIbctac88;zC8Dk1=oW$Y)4h}ER)>P2_DI`2coBf6EdXIdeS$E% zeKL}c@Tp?y#PSrwtm`wyF#r8ru@quoD2C?#5-hC4QG{{3Ccui7G92@uvpt359+)Lm zLiB_O!)=O_4w&ZJ59^f=6c*8tdS`44-~jsB{Sv|ZJOC8tcu>k%m_6iCDJt|p#sM_< z!w#B@dk_w^kv|M|41}?*PrQZa3DN#8o2l=+W&zCPK+0wT%;bSW-j70YqtDfSu#n$1 z3t%Uo##Pk}UZnOnX8Vj>)lihN+Fp<02*>)BX_psV9jMt}c6wg?JrsQfQFH;*9EWhe zNkHMzQeEl*Hz6o}nggeB*N*OQnrkuA9mQS?x`Px=cgQUE&Bj`WLpBxNREmz0h;AxH zM@t0TI|eAM(O4lL!g6>VlgCSW9360iM3~J_1Pc4xBq1N9+f&iW64C9c=oE?Q_EdDL zM09&9I!z+18K+CMh0qL%u;(~aBDzZzo#jw~T@V7Z9k9(u_o$+CB!Xd@>rjB(Lj>kI zV6)L3s_1-)uq0X_5oV~F0v*E8T__QT?joS@+ANkbOwbaEQVA`UD2))k>TP?WspBEo z!sQad6t0j6E7p|~!Dp>R+xEb$?+Ye>>12CwvkYYNQ7M~cAd`=lZ&KmmVr$ETFRL9eZ%B$rEHdgO#V*Fusq*0`3ENl*iEBL_FoUMMMdC855kW0 z6U+Xy7sF11M>wqa#eNs}t=t*hcbiO#a=;w#z0&|8T&jH|s@~{%;|_3q$cg ziRfl_^dE^}D&olF#{9#36A8sjG>K3|qRFT6b+rQQq9tRBa0b3EA(|kI!t|h&MA&&P z?U3o=?_mvIMk4ICp5>5fwD&N!&vwXWoJr^$hiocrr=BYj=Hur{G>1@GiRKbIUn1<* zULetYLKiw@E3tskMFJhB=PIHXO9aPti9~Q*mr4Z3b(utPT$f7($9087a9meP1jlui zL~vYJJ7n7HFecE~IAl)fFkIKQ5}`+4ClPw&^%9{+-XIa2*Nqavd6g6By(B_6NrXA% z%@QROxWf=GnTj z%|4FFD5f@i~pj)1{29vl&dDDP>He zW-)oTlrf2#!{oVA#w2QQn< zn8{0|jIq0v$;+gSvAdkfE2NCEyOPPPoNO;O#_nn+uW_=y)EK*KnY_-)HaEuZdM0m> zGRAHelQ%lq9vovgo5`D`jIq0!$y=n1vAdPY+oX)KyPe59q>QnF1C;qvP>k@N#>`MvIwCPd$mG9FxclgV#M84s@PVe;Ej#=Y#lOx`Eu(IoF@ z@;g$-s{H_y-<7ht;l|{{QihRukIC;#8Ajp*CVwbp7>SRV{IQf_B#too6DON~_kmey zF*(o4rel2oBk>uNKbNvuX)*arDVvoRlaERngZUVfk4xFCw3vKS%4Vg-9CX)*abDPu5y&*UGZjKTb0CjTg94CbGh{IirXm`^eJ z7b#;f|H|awq>RD*JCpyAG6wUXO#VyC7|ee&`F~QzVE%{6akQrvTWoy@M;s3n&dVZF zPC1R2sS_L^FVhn1xieU0MWP9;*iy3CG^$l;CYO~1-`D`hVBKaI9pDSfdF3w|e zSt(<3aXynTkTND07c%)GDZ_4D%;Za?47+hDlP{Ap?8fCxzCy~d8&@*}6WSARIcwsv_w}3u$gtO(J^xBU)V|dix_< zLn3?S-V z5q1+=N`&2nRuW-1p|wPqjXe!ydN(~Mi*V=`(tT2LC2=1u{TLI!44;5jYb@h9#wRj9 ziSfORA7=a;#=mDAw}M>7%9L>xi$t$OIIQsXj-SS9)eZ2J)vhyiS_#oXD5EL0!5}om zC(A!YUmPsprx^wgaS#)OxX;oJ9O|IS{^@9fvW@k7ZRZfVuRd|NQ&ni6E zo?tuR@X|hqFfP^qYunE@#Q0{$cQBsA_#VdJW_&;6?=XIl@xzS2$M{jk zPcmM>_>YYL&UoB;;Wegqjz>7W_N5pv&G`9@Uyj98coA?U+TQ1+H<1ty zTQHIFZj29QJel!S#?u%d!}xf{Cow*m@#&1uVtfwca~Yq<_zMAoM zjPGDPm+?0k-^2Jm#`iORknzKezsL9y#y?@afbl;W$M;m+^*SHn)pWt>nqI*8#f)FV zcm>8QI(|A!Sv9~b0_G;kSQyn&^rs8`^Z((w7Mdjg|DOgRAHxc~*A+;WeVFk^j5lVy z3FFNfZ^ii2jJIL@S;n7ZyglO`8Bb)q8{_>MAHw)J#>X>0iSfyduVj1`ixNXEx7K9=z%j4x$;8RN@6r+35I$U7-(q|Z<8L#*m+?c4A7(tyb6Qa$96Qe)tB>x$ z<3nHk8)J|5OLml_{wR@X+=X-$Gh3i%iV!wOgaH&75Rc^3hz};dsa= zq4&)Z4m(L>&uMo|WgTm?HfKqmR7ob;Bu}vqq*4W8{#o7RpX8l-j!vQ zp@Wkp+YBYVk|TU7d!@`VBhh4*WQt6ZJJ~kWRG%agor!SR3bQD#>b_WGzdwT_u@lFXj%Pgzk7F9G*rl ztRwewOj)7=MZJB*temp2_$xp3|$J2>XtCYyxh-{H_@8zx<&X zZovGh81BIQr5J44--^L{{tql1WO0{KIP8o`SH$=TghM`$@l3{lXFTr8So$jv4v&8$ zr4 zjGu>a`0CLGEX{?CU&PX1!_t&vd>G?NjIU;V1LMCi9(Q%Do;M;K*0UVrcQIat@p~C> z$oTz?Kg4)n#``lqi18%G*D$_;@%@Y+X8be8zhwNnYhveh1Hxgy?Z9|P#$RIm6~;$1 zK9TX+jAt^wj`0nQA7VW2+E{%aLpW^z7L32bcoO43GyWIjb*_sY=N^Q^^KHWTW1c5O zlMrqS!)d-6k>O1!b`*lq^d~ReoUIYyD*^k@(0V3BNBENP0SYod$sXWy5Cl>@z}FrK zqYmkVYohULL*#qfH;9L4Z{!Cc3JBesF&IS@7g zUN4xh7~U^fpcq~-$W$zo*h0nd5XB4Xz zdbVP4>YEgUQ{Su@9<11+7@n-ysu&)v*rphst=O&@9j>K?SQDQbAo)`FTIw6ma=2jSc0wLR!)Q`GUGvjufMNVK4y z2i*W@QwPAb8a)K$#U3_weGi7%THohEPn)8F2YoGQ=s{q?{T>Xo-~kVYTJWF;VdFpK zfO$G}A1v*|62Z_ma>&}FO?V>a5yt{^mFSrt55g#BhbtN zTb;Rt9&;!#S1%H64iGlu<6i7&Pq2jt;Z=CTgJ*0JPkIox{8Ju0M=4IXHmMol%Q@9) znSUm06MACEl@vB3{7Wmv;9puh7KE4nX%E6H-Nu9PNu zY&Q?Ww{^RF5LT>*2jP31Q4hk3_4L40j9xkd2s_hIFXC%hG+>7@agGyh&%{(?u0uf! z+nn?B^G#qFEUYzOb=Syqbzj59tA#qkwdm{xbMXh;mR#>DCl7i zz0`y57A$kX9tSRUxkI)KY{nCJD;zV)_MT46|UT2QS;}o#TKhdp}I@ zE{R}*a~%qvx5wG-fq4y?oH9VzmE&%pFr2Kd+BWk9I#{Sjl%7JpJ%Q<^ly06CXL=c> zn}@}jezwxh)8b4&SLx<)ai*75x_Mrl=@%&7JTT7miE@|)rk7W`c`Tjj6_swDOK19BN;eOtGrf}1&6DX& zucCCk(o&V_)s&8RTBhSIT}SCi?rl#Y8owV7T=>3FTBF4OBN9q+Z=!}NQVju%_% zGyOiLW47Ob=?$g69fsw8raz!`7?uZ_{*cmPSRQ72Bc;QzJi_!xl@7zwnCVTF4#U!v z>CKc5!}1u@n=2iL<#DFBP&y3D6HI?n=`bu$F}PdrJj3+1 zN{3;2mg()34#V;s)7vW@hNT13J39T8ar)a~SUNGiv(v5P*$%_fh3Sb($N2Bc^lnPW z`0vj29!kgfk21Zd(lP#fF}=6aG5-57y|2GQ zAFOnY{~=5ts&tJ1VN4&cbd3KOnEs;DG5%j-`pZhk_Q$9pKxbrSY`=8QeEYh-RpQVOU1Fg2^$BRyqvJ7^aU^It&;=xh%tcC)$sE z!w@WBa;B5*K;HpFu#oAClnz6%nCVND4nwe%>C2Q3L$I9bE0hjHu#)Mklnz6%n(1ql z4nwe(>FbmZL$IFd8H zWO|O$VF-3HJy+>41iP93s?>MF5WL3p*Od-K@CMW0R5}d7TTI`hbQprSnZ8%)7_a-7 zzF+AWukSGZfYLEu-(~tirDMDvV)|jFW4yk{^!JsH@%jPNKU6x#>qkugSm~Gu9AWw= zO2N!B9TS1inEtuaF%kHJ>0c@xvuK(+iZ2 z@n6XFBBf*e7c>29rDObm!}M>Jj`9B=rhlh&jQ{VM{)5u9PUoEJ1mBZ^?R$pKiC&s# z1^=iDhGF@M=|3wShUFB~e^ELN%dbrTP3bT!zcc+0rNglN$@IUJ4#V;{)BmS*7?yvS ze)f%G>mnzK9Mw6B;U&#;6~n&Hd5YmR&9aK&JxDX-FIQvM2x zVI#4kVz>`@r((Ddc$Z?h4|um?*oCa5814gBRt$r=3RqazI!ecmU|q$qaad0=+;h7} zG3*rHs~ENl>nnzPZucpMdu|OB!}w?j7GCp42#44FQJHoZ`f6jv&{vx%hQ8WVG4$1D zilMJQrWhP$bFlE5w?H_oTN}^m?J$)O4yrBFpH(^>R6C|Wr*!nS_Dt`fbU3JvVBt0G zp>*`WsAA}UJrzU$>!ld_UvI_G|N1C~{?}JA^uKD}@ z8Ok}3iG#d|Uzj0rFcXJ(G1ZDgnK;ag`0*LaIh=_vc+q@jlzuITi7$CE-R685AncM! zPQ=UHamR9!=)=MET!*3~3{6%v+0Yb4Qw&X2G}X{FMbiu&spv>U(-loWxcziKvu=Q& zQ8;pjK9d%7uDAd{`#^0l%7Y&*812DN7L4%#zYIZH#(Hqdf^i<;#~~=icn^NHV1ftu zVF*ew(Sh)SWSYj9r07CJCo8(h&?$;8Hgu|@OAMW+=u$(cE4s|k8Hz49bf%*Ley4&? zV3r5?u?hmSJ-|;@5SZfuey@VSTo3ST6$IvafS;@&Fy90GU(xE1d19`Dnty zECV+=Xg->7a1B9PkOGE&W(&gMaku)!=D4|A%ptaUYW4rtKHTZ?)B8P6}{Pz5Z&ik zU>ptooRI@|k7XC8G4D7Q7>AP(J>UU;=!8klSnt~pf z2Mw$L0m4mjG&*|RLHtJ2hd|+(e$0}7;**+l+Kn0Tr;1?)oF~~X%(^~vEC^lY=K!V< zdd&u5c1Bap8GZRLiZl93Q*%Z~LBlgTfpF}M@Z(q~nOx*$dls2=&|<|fZ~0oXUHE#< zH;x72*TKJaz+S=Kn4tUzjGaw}Ih*es4PLP(^Lq#K;yY3me?T;Bj~@{>XJChQj_H*@ zIcmDu(O>#z?tH1hM*fC)3#c!V4 zF@T%(zdII~SrI)u??5;P@M89#js<1{L=Vn;fM4^W6n_Jtjf0c)hrs_Fuy)`8ey!^t zu&_zv%DD^&kbyp429Renmqi%gmCu860b(W_Ed~(|`_;t=o2!D;Ii7@}atYI~MA%$+ z=;aPz;eM6ZBhgzC4v%{W}g~D(tzoY zIDL4eK?5rBQ5L_6;*DeRn;KBwCM@sM2%9r58^=z~o?RQ3umi%p-8ur8%S-pK5DptY zk@2pc)31#njFR%=t5Bt$chSH+&lHIUEbTxi=Ec{bw1Z;NniL%zi`Js(kXW=fMTf?s zbtpP47OhLs;fUfi^5XBL=nGCYO?x~8TL~}5lGLZ@OR;EqioP6+R-ouB?f^lzI5SL= zJiw1xQHl{Bd}C82dvMHx6c11_%985A<@Ok99^faiD8)z*uCyTC1N;gWrO5CAKc+%p zln3}BECQne%oV-Xf-yb?ehZ6IjP)t5w_uzH_&F>}G2Vk40qBMdfawV|Z$}tcJZMIL zDD@-{T3RsKgB})4@nE0ji5 zu_W~Ae-BIth(s>~2(QoOUJS4O6%OP@`u3xiyOJfo+G*}F(rY~EZQK4@56n}Tw3*1V zmvdrXWI!J}xtn}EVPMzZ1a9^qGO!PoeGAKctJ8v)Q51c7l8Lu_abCO;?_gqiFNQfQ zFtMT+JK8h2(}TY)xXXj)7ToQD>2Q%~C4jI!D|;~<(^WlajqH(VH2~A=$-#Ot9EvqO z2rWQO2ToDfj5~rEa4m<-1o{Xjz_lfU*{L6H{jx3!>1 z3;ML6)kE4w&>A6qMo=6Ve!Q)qHADKWphyd^-cC@I2KtWC$4tZ10X^<+QHm}egcIsS55fs` zR}aDobvF;f33Yc5!U=T`55fs`)PcN+F||EeyeieA7mHV;cyAVm5$?m{SoZW~ahTYC zEDnR&pT*$^o@a3wzJSHy5eCHK)!+&SB5tRe<*Qa8Fo=O_0D~E*4lsm)8URBXs0lEP zfm#5=8K@2L0t0mbUSyyyz)K#KDo-s*nER5pndQ`-@onCd2TV(Od1iK%cZ zC#J?}oR}()em?{rZ3ZWzEl55DBlSuG>?JK0P`8>0zDAGo~2Oa64r*m@E zgLaX)xEIdY$-U-F>TIk3x(A6Cyx~E(%6ij-aGw8`2jP-?j|bt>>TM6q(kdak*Mt7H zlzkoq7VP(6pat)EFxY|v9t^eMT@S+9#6b^Uv?&gGV3t$#qn93pUE)0t!Y=W?2Vs}^ zz=N<$eCR>gB|h>X>=GY)5O#?p9)w-u6A!{J@u>%4m&o&=qdk|;JP5Dc=N=^56km7{ zUb!zl2(R2%9)wr!s0ZPdJLW-n<&Jw0UbzzNOU^mGd!m)qr2P@ z6HxID8>kBLis7zdL@{h_Cn%OptdwH7X;xaX&BV$mwuRVPiftu!wqo0eoue2Yu{c*T z+z&cWF}z$^Rx#YrIA5_{#4b<_4{Tqk*luDMNtTsF>|(`65W7S%+zGu@F+78GnPPYb z>2k&JyxbLv;d!|$6~hlDUZof&(pM`sir6)Z;kOd6Rcs8g>lDMUC0?)CIAS*_hTluP zQLzcc$|;6Do0}BFrp?WYVb|ss#jtI2t721$-KN+yVz(sXlhq>l3A1l4%6o<9q$6nWBPohV{|TH zdZyAbIu|m1k<#%lz+$E^Q99lQSjzNeO2^}y%bC7H>3A1lCDT_a9UDcfnZ8Epco$$T z)7L2-?*go6`Ua(Ek)Fl$jY`Kj&1U*0rQ`PcW~OgZIvz>h%JgkY$D>=@nZ85m=3OAB z=O`U^aTn8bm5xXDcQgG}sb^#SzsB^}m5%ZM2GieEI>!H7Oy8sQ^wYVlnn7o>RgaxZ z=4WilT^7A$#0uW43Wj0X$MpS5hhce#=?9b!!}2cE4=NpokD;0c@xhUF`!A5}UG%Q2=O zS2_&K38sIebU5U1nf@Q8V-xs0rvIpP4BVf*9*O>paJbg_o$=f6j`2GXHjXe7EzkJf zj8|g33gbOIr~Olen^KRq&VDo6qCZRfyiZGS>@q%s@l3{-GrofH^^9*|d@JMI7~jqK ztBk+R_+G{jF@BiwBaDB-_*aY{WxRc*SQ{rH9JcXn#^-oWJCX?d_A6MAv6#v9pM+kV zi@x|Xn7O{RPOTi~KZQxo$!(bU#5-oL$;oZ_mR&?KtSb`~!#t{#WA=F4F^4bhm_6PO zth35EX4CD!dgm<1!gQI$&UP$JhxO+8RgDj@dHOu?D}`FBRv3(>b16L2q(ATh7q&&;nQ%HXaRrtzzg* z*GV=33+n3?!wWMvNHzzH$r~NBCq8!pv2u>t6JLxAc#~vHP?wt(!vg&l#c&aBRSX|} zyv;FN?ow>j-0qkycP$p)cSyDl9iqHs>u~`qNVWkB`HGI&GBzwCcBf;uj19vpeXyRm6hU$BA<^vU}aL*H%S zn5lEYDAcc^W2VjpQ}Geb`xV3aKH!+mI~|)#4?1S^PDdYqNHM%9_ON0wAdMuO0VDN@ zW44SLxW11%X3Lm^4a&xj*>rPpzD*Q^Gid6V&ASF=G?Q#C`srhi+2gH6{hB*w^R7eN zKQ7sNv|kIwu;KKCV(7b1N@m8)Q;H#POUGqDDx+;b~)J?MKxR%`&!zN=7$!4KVql#g3tEXhMVb^*o zhIZ~P*&L+nBiRD9XQ>3w0SHSvJZYDp?NNZ28h1$U@G*P(mJep6AE%^$SHsw@d=p?TwhQ>&eYy>X;2+5K$0Fot3$K)YJF%0fh z#ZX3?Vz`?zQnC!pSko0l2g^_lgJ+avqtH1=D+b3oMloFIv69WgU4U_l!ElY2Y#}BY z6C5)ax@aNlJW(;U%OuC_gD25op~Q{p<`h>tO6DZR-BB%xLC3@^wTAhrK4SzI%di!PRDgyrWlU5 z+%Z#b@iesa3dyG9daRUeCY-@4$!5cVtX2#LX^muaVEETcHV<`Kr`UXA>lK5s-JsY? zVp)Ey*%A}N7MwVY&*dm?Ev>9v_&$LT>Y^2Jn< zx(=8O`QtEKtfv_ErSI_vq0fRKjEbJl+t&#uQ3)Am=JaOfguw=8D0xJT6%p z&aH)F@Saa7hS}SbieV=7lwz>fEfvG^ua#oh)@rR7yx7xcm|u}B4gMfWFwdr#W2XmDTYorUNPK6oB(D9 zYa}`m;c#{}*`*B2i+`~>VR?aC%3_+OcN}B4i*p71v|M7Zf1sJ=yEd^gX@{) zm@yxPQ*oJRI~H`c6`A9JNpy0Xnf@q-xyC%lOoj88V2sRn%;e3V3mdt>v7kE&pg9ph zILSGQaM)fycuqG6s}VPoFua>s9y1;~RJ^9ipb^L|^a@4in=`&r(G4q*_9{iUZvwqq(*LBG zGrmUAvF2J_tLQY-4%bQg?P7Dr*L#XCSpM6YOTNuCRleb0!hhzF5Q*LhA#~E^d?M3# zad(^QdXu7b@0sY$iqfzrdW)nO_(X4&^yCiH;sv|E;&ju`D@&SBw^->2 zRU|E-8%sp1Dw??pw3?!GP5V}tv~Wo-(${ z9ZB;?n|7!x>B*goafEu3=1(&H@g7CjE<@UTB`us|j!<9HlR4(P-6v^Lwy|&xB+VaZ zdQ?M63zwQ6b-$!1bIcWbK+>Xg)9MdunvMEC1lp7alywf%uy}b`vhCPHYUEfj(0Zgt z955LR*Wt;oN5Mkp+QR913H=9lr6WAyL8MyM(@Zm}R|yVN5pB!TvCio3!IP|@YEO^UZ>@mdsrn#F5VybX)jq4+Z_UYFu+WAW-$DE=&qSEYD67DxS_ zV{z24J&U7$9atRo>*(Ua6niN;c`)6A&K}INpo<4{EJ*ZVu?1Z{SYkmp50+cd-Gh}D z^zdMn1yK*ySkTjhwHEa9V4VfMJy>r+9}hNI(ANRe&)`34r6L%-C#_T@Bi~6Y70JkR z(n>`#@|(0$k&L`1tyBbq&!m-#WaKevr6L*mOIoQ&M&6QEDw2_}q?L+b@RYPtk&OH# ztyCl-#!Wx)gw`dTp21H2%3oz>(34!ZCY1a$~fj5Ug-HI>2nn zrsDR{9LIuw_Qd8oU=CJ1VkIS-Cs=+ePIkUz9&|)aQSpwOfWcnx-BLc+&$eE6AaFtZi`8_1e-Hij^#zF!zpcKaX6)H z7Oz9`O)L(lv^f^9QRQ^rw`%YWwcHzL?0vVeg5d48vN*imHWr7s+s@)OD87Tm;q7*^ zI8Ho=#c|@hSR5yw%i=ik-LZI0c;i=H+}ug1ipetFG!w9zg|7=(-NH8ntYP7s0@k$f zEdgs;xJSU+7QQWD9SipgSl7aR9%2vm?<AXicKc=jbhV?eXAI}(SH=f z9@=+`VK?u4#jySSgJPKV{8uq}%O4d(KmAED^wXaeLq9#G82afiiorSlsu=q2Z;GMs z{;n7%lYc0N{`{w6=+A#SW<1l06gbqk$;PH$8@%}0tsHkcZbYj>6keGQeLqI zE;*4h=0r;NiDaBiX)oGrB+@Z4EXpWl*@@(pB$9HLS1vR~tvHdq{Y3J5a}t<(o$Ym7 z;0h?obRJj&oa04X;3`uUjO%m%t0S75g_;B-;v%nL+J7Q>-3hZYx!7ZSsCA}+ak7_q#a53>Sn6wV zsS+t0RX@pA?=mmiq9`Z&=;a>UrU#}AY0ergb%ob2F*P)L%0gU#lnmP)uJlRRAyVk- zg{^j#*X`NF4t}*)Y|cm}toqwjA3fHKDsj}1ss83NZK&xEqb=%CO z(}~k5!=zs4MSDJ3P?FK%u2%|OWx4<`;WzwSp`&5Sf1_7yQJYZ-^nHx9a$d9zwAl_O zQx#mDo4jr_Z#8`(9Emr3(bjXP%}m*D`F|Cdi(92)I*&cK+q`1>PfGfUWcbtD6&__P zeuu);RWK6DD?Iu{3LH`ek4;Te#{0fgQ7IG5C4xh}(<`QFtjSBZ=ZG`8%j@=-)+8e5 z-Ci+`mNL;aCkYC(kT6H6tCX2kgA*xe=6Xt@Jk&8UOz!!&LIY?UDfcR67AlsE zc~*U|*!GxbIsy$aw8wp3wAGtyDgmW|SM2%BvHh^2$2P+}Gc?fd_bY`m&_G4gJn;W2 zXw(P2V(T{F4Pls)hrDQuGNL))!~arXF)5qJ$mo)Y)_?r}RZxi*N}%41st>atU* z5~Q^Biai=BR5u!6s6;C-+N06=!V0(c*ftJ!c{3W z!{ZqNt6JDrz-ksgD`0gC+X-01!si66X<>T-YgyPqz}gme6tIqkodm3FVP_BRn%2@T zl7{D$C~0_7T_p|As+*+YX?2%0Jg**-h9?%4G(5AOl7^?&OVaS%dJ9@Dyj*=G4bQEw zq~W>slQcZH{*s30_PnEc2|fCEqHY#=5J^OQKrG&A5XA@jctYn+0f9jtMEYUzKR6ce z--Y5sV)4X26d&s235k8G5g5inbppdZpr3)J_zNy>RwVh`vkNjN5`IzOf|+aWLggia z^Or2AeZbSr@~Q_lXqGqajAwZ-i}DI)jxX4VrTr@&V~Ep+Z+^~%lR2~Pj&70@^CG6v zN5tZN(dfx8Zq{!HbHGv@%Zv0uJT(^Yg?Ji^cc%ErSiBG7>9Kfs#4~(6p-ZRU1V(vK zs+T3BJ&E-1Mk&U`;(ZYx>*8TG!Nw_u{h{%WQPmNj5R3Ohd}1u#V>rbp`FKJv1185n z9|NYuKz9SC#=t-Wra2JS4QDvrF{%gRGh*>X#An9hy%3)ji+4lUogIt!MSPBnhh>1x zb&SeDd|oWx1@ZZ@crU~k_;^AeGaNEwpo;+uJ&2h2A|FraWx(PX=+g%SXh{roF<_|& z5ffkL<8%n*Snh!Nf?c2E8Pf(3UEwJ_k)ar{D;*AM(a0gN%7MIuUZy{$ZVh;NIi_5Z~?ML04PIs}7ih^g4uj&TE48Ar^_g4i-M&@`ls%BAuV7^l!%EU0}K2 zVsTueJuYtSa2L8jGs<_qrr`kwh4oeX)4=VHDpVi}!%hdWXgPQ~W?I9_>r< zcVqEhy(oUr#e>J~c^`5hFVbruB{&?5_r~ygkHvAo_kBE}cR$#k4?KwU9!l{KT|BtQ zmhh1Sc?o@@unHeD&=25<2a*0gs6jqKJZz9py_V3wKPr^xL8L$2=V!6_0K`9Madf9I zV(}qp(Jx)xjMTw&5pdM61nm^kqn={oR}~M~(7v&N)d-%>JJtwZqGtHt8GFa$qO|I^ z3MT}tVc|&uYg(8uU@Z#^1gvdgp@4NPEE2G;g~c9*H$+Ucd@X6%Sl>vB)}ki-R?_gS z{v&C4THi?;p4a!1h9~xeq~V$USJLp*ev~vkx1R*9R>ju$XGz0zJ0)p&Zofzxp4+dI zhUfO1q~W>!E@^mfe@Ggh+ni{wHa8ZvQx%m(ZOiH}rB&4H}c- zv#R5kxbaEP_97hew;4ao_+86fdU`1ZVgKyY*Rw{@vF`^9ABuQD>G-PGgG_%&>3DnU zVWu}yI=<@n2-6=`I&6AlrZ;hV@VWgoVpAqIbE0t)U(>t5k?3PgZ?1GapY=G?TR8m` z*@U>SXW`3RPcZ#Sr-#SKm$#l`dP}9_%Ui9O-dgGS^48N#Z=-a4dFvUbw^cg6y!9;8 z+bJDi-g=Jd?UjzN9d%%ON2TLI@lH(dtaN;Ns|(W;m5xvPb!B=trQ?%+-I?A)=_^T( zGQFqL@kzg4Oz*99eA2HE)03n=8=ZRu)035s&Yi;aRHdVHr!jq`($TronV#Wv+rMU` zbB|*BXs6r$HQRi$lIdfWj{ZH4>Eo4-{yl-|6P0d0S?ToCdC8hVGL4At7mytoi`nZa z`qPE}`Tywgh&YUypXftKaWmq&$0f!uihqh8qHkUSGpos}U<{lou3*xqDjfr78q=pM z-Fyp^=`)pXzJsy^_+` zlU|wW)s&78<5g#R4W;9yu$oM-rF4AJvNqG}C>>w4tjqLzO2-#1?_v7AO2-#1>ofg6 zrQ?g14Vd0g>hp~6WBLP1H@=VQ4=LUFKBhNPy77HXe^lwl_c6VR(qSH&GQFA7jr(JI zbEO;i$MhCTH|~$=Pb%HGKc=@-x^aI@Z>@CW{+QlI>Bjvry{*!X`(t`Lr5pFh^!7?O z?vLpmm2TW0(>p8OxId;RD&4q0rgu}iaeqwjp>*T^nBG(A#{Dt9x6+OKV|rhwTl+E( zp=rY}=EhT(FiuTVOM;Yy~ja(Xb_P8L>s@RbE?JUC&& zS_kYW=+{seTjx-aZ!htBfN+(y!HMPz?ECSMOO{0Ggf==96xd?29k4xP?G#G1NwWEH z%A3K$qP8d>6DC)0D34yU|}>A6aW4cN`}SEarHL-jSLzpiu) z)i;>_rqt)-VdA$O3yN&R?Qy^~+_5cqoZ@Z4zFvS&VC)488*ZP{@fD5zUZ+n&BOLCM z9ad>EWZz?H-}hCQ63s(6tlN(+ZP0?| z?sVcmdC=N|pFQYp!6^r9KU;vG82AM&Y?|Mk9<;LU`@08iZD;?(r=}_B3RfBW`3Ho} zQ6kZLj5lO_DC0?t?_vBP<9Uo9WxVCeu-wymn%coA@-%hnmh_pdd}w)%Lc$Yz$rVV= zmBjc##t$)`$M~0w|HF9Ps@U;sBW$iJeWix+=8U&sye;GH7=MHD&lvxe@pvl7o!40i zhvlBb_=SvL%=ndzmt*`6#>+Eanei%~(@SFrH>EBaq+-58Z;d%%`{kOg#M(O+bhK|j zbZ{UvlK4naN3gK-M!k+j?S4$6dwQ9E+5=(whw}RSq*Q*~vGJM2o>y!kF{FML2Q^}c#vbbVt9n}1;y~>#*2!j=g07;my-8;PYTmQ5^Gu}#F%6vHF!BNf|1EL}15oeahB zaMdWqFpnLr7(RwMMlswoAFCK1l^LfP9uym|7+#W^pco$Knkd%^#Bw~vcn@nu6Vwh_!Q4Dj9rHbM4|7D6zC$?O%8N^m7hSvmE zDmIJQD#h?6snv?%b%HgD%_X*0F+5GXPO( ziovjMR1AhSTQL~cO^U&=ZdMG2b&Fy!tXma>Vcn(}4C{8qU|4r32E)2jF&Ney#b8)> zDF(xus~8OHZpE;we-$j8b$o{~{lkL(2gd(kJZ?=a{gNZG^cxTkkMlO;?=b$C=kyZA z@07kNm1TTuQ5FV#ykG@$V3Z?{1tYCfPH@0x%tppif)(t0`iyQVCOm(gs-`t=YUOQJ~m!fvZbim`Hr1}-!Djq|G2<0lecgdF8_s+ z<-&GeBv{c**zt=cn-BkSiDZl6doC5MI2ktVGRJIPR=~Dj?wF}d!6uCTD+DV{f!(-L zvI$scUL{!3MEIkt1uITNH@-%)T;c6`QzY!uNSOf4gAavf)!?<&Nm8H zG!sLhoM6SEd?&YpU79ZVj=}ukF2Rb;lm2%Lb}|?Kw~}D_BQbxe zEZG>eRTaSsrl9SsO12ulteRkj=844WlFflBtl?PjvK?tP9WWqRwqin9N3i0#7~XXyTZ?q{B-@GsbB|-DjKW2j9Ng=eDWh;H23vi}w!pXCCs@%0 zT<`{h6^}(jHFPW(ZBO=o2kc3#h9`eOu>8g76%R_5gM&RJSYZ|_@~~hWArr^ta#4W(|Pi`!4$G*=UqfL{EY7MH4%m7FUAmQDp?jP-%PNA z73gk{NwyVJnC6n@z}!79Sm7r0h8B`-L)U*ou;N*mK0YZ}{uoT-o)WAm8R=RImYuGWGTu0Xn{CEJ1v*ha9T2{4t<2v$4`X0fecMdo)TT?ES? z3%i!+m^ohIVyt_*3U)FV!?2rR`ML0y-32?j4feT*UN5Y!3x&F6g}@)kZ#RH;DBx9jhI9X zkZcSt+Cax_0b?+g8RVGFYc?4M3syJ{>4pe)atG#yLj}uELn9B9EFC8{T(E*gXn+?4 zE6he`c~P*UQ5bzMNwyjt=w-o*)6r{R5iEZUdVG>(lVGw&IOe{NiKSaVU4LVEGxi z81p0>jlAKK+%Wj#16)i^3Tj*FY+uGGd4um}qjj~v>-RQ=5ka4xGnM!SYjZzB!Vu zN4dKs+W=3Q>zEmG1=F!|+wGW}0=(*gx$=eS<0;W=lFdRNe_gPmDLKU65Uh9v*qe?8 zG9%K=kB!EChf9>I!d;tbvvEPph{%wE9?=3#v7lWYO@Z}&T9&vY}~&^wOVa(AHn z9uTZ>BFcDIvT10ggOV-88t{;0n_x^23s!9A1n)T(9JLMbz5})*893Pw1S_6}F7csY z`AI1BBgrCM@JyOe9+zy<3SuWDGrzWRQn12_s9(Nh zGvFo*B-;gRSSVQ0V$``vF^tb*$AS!dWxsa7Hp(0n@Qq;kV=)lF6|7(ftm}US%b$qt z)9(Z;Oh*^{Ub4wBMn4EvGy})`uVBTq;nRMUEDKlmC&_kTk@>S=1@n>alw@0B@O}}j zC>pSV1?OOwU-hse;sC& zr3EY4gtbB$$!5bdoF!P1`OTEG9ScU-20h0C+sn)kRh{ctkYW>^=YTzfov3YD$;>y@ z&zEdQ5^e5Y02bcFyvXUcbr#}RKrUwbB|Lg=40&g=1m$u9R#J=73i@X7Uy;fuFisvZXlQHHyJdUF(=FV;PLYb%GVoLpQkI zFTRUo!t~pOUYrCMa=T;Z zn8hi0X66o-r=rvsW5Ru>VrZPZBwK=kez#;>(0?mQWF3!mNHv0#mDs2&cOjK$`Qpi#*dV3yTW zvP>)%dO2naC>Vi7cW=*1(FEX!C1cQG`*?_1K~cs`vYdUv%neZ5trPmmZI~fE@0h7r z{zx1=aLg2#ZwB=M!A|C)I}8*oKMhxKkYpo~Zm?svj4_z43{ecTnxT#b*|yb&IbbU? zZ5kyS?wCE8SrES9m`!J_#*2;xi|Jse^YGPzgOsAt#gyudcK%;-CE3y!Wm7F*mTW23 zD6c36`5iF}El7j4 z$Z*V@TR|#1{3yqQE%q{vcEBb|%cMkO91FJEL}MMWiOgokILRiUmBvdp5lh|)l1;+d zPn2vLjN&B6f+e=l$sSC!V2T6w9OurVTvHvhH8V4zX^sU$t$Cg9!5n*}86GUOV5S51 zFgtPRS&rG_c47fC+p!?WW}M@INmQ7GS=?O5f?YPzJO|9t3+H2|G2bzpF#}_Ffnzq^ zXv~f>9SfG*gDrHxW}Jk3GK(Cu8K+|LxmYn+qa~8f#B^k-VpxwYb1Yb43tjGjEx`Ot z&I-qDMa<(7DY!_wT=a^+KQ}mz$VJVS*@3B zGcMi+$DFsza=>QH!Sr~eW5H|o=-CdKL`CD!S2syE;s4sZ?;tCR?|uAtFBwrJ=b(r= zkb|IL1Vs_EVgMD!tQhLYK43nXEe#UDN8&W+5(XoFy;HPS-k+73ZNV zS?4U7FNM}SkV5vaOmA?Oyd;G-5=IGZa&XYhr}oW9>#^Bc^0E|q&VdwKgqS_=EO|u= zz2HC!ZNOmvMQ7cx_5Iy3FnB36`{Um)ht?mR>?@&-!=V3FXUVIw)7J>|1YUO_d$fP| z`weHwYf|V<2ezvF^Kjk13N1jS-*M(Xdh@OW`|HvNrcK4E*%BifzO5ln zABx`YJ%@H5I~U<AlMnNNH3_nG+uoG;M1GYS;+ z0VN6%(p?`uTrXZf*=y>#_y~LPbaoN!NDrfo+o?TsAFlWi=~gyI+*y~45jP3tL)>In zuMpyj5Ag-Hia_0IwV=Sq<33tp3RDN`&328jz_O2UgHw}e`l-~%7(X26C^<>`uHy+O z3)FI8zhUz+1|lbfg!Zp?Na%=93<=qIQb-uAoE*|TL#Kd>ni?imqzb3935wY>TZ!oMZ8l z5a(LFG{kup+k`mkBeb5Eg*faZ^r@GJIKg7u5NBAtBE;N}arv|(;$q#7(aBXIVJvc8 zNEl_b4=5kQpIZakj{B$ELqdf+hlB&WC!l;h>Ukg}+!rPxp@VuPB=iSQgoLrlGa=z# zuSZCDGSMp}jNST#WbZyg!p+BkkkI!H3JH&2hJ=K>py4552sSz-+_#Mn2@#s?$bNk> zA16A`k!?To5wsZreS!$h3JDF|ynyl%+C>3Xg&sK z9|!aa0#Cdk_C1S+hkB$+0KPE!E_mVMU z@5jc7y_a$*xiR1Fy|hC)OY`kE%fyInmW>hHEEnQ}ZK!X9aV8Cm0x66uNvZVyLz=4QP1iz;w0CI&~CG4h%4>hkBiWjJU+x#cJH-f z#NJPc5qqy4q21<*A+EN2KPf_6^5hWLSUe@fwYEy9Mrcc(7UDWv^7II8$uk1n-rbfw zGe#WdSux@;>qKa`SvN*xUA-8Qb@fB+VNXbd2<zo)-&vRo$JzIp>%bxj`F``Q6#fU1MAE7-<7sQCYUl=3y zeo=_M?cOhr5qobHBlg}pLc8}%9NJ5JdvDu8TpAvG=wS z+Pz;9BaXdYjM)2?A@;RC5%sl4bWM!d=Cuyxhz8hgUKb;d==vCOL^nie z_kLrHIHLA34mjK}q+xQt>8!gS@i62jw>NtNwk_Gd#8lzt5SLoK#i5*l{uXZq;+EO| z7HG}wgSKO2+ac1yRy#&I#OiI44z+rFq`6k_h;*2(LnkPPBXS6{wqZbgXN-7g*V$om zKt>*SInY(NW59H`LpMIjCj20)-Qz%3n`8HQZ;aUEeGU^m^D=P116|eb@d1a)FH-73 z!mk2d9LQ?(>>eMA5qnG=CV$GRT^;DEc8?D`O#YHm-3WgRJmNrBn{W5{XpGq7V-Ayl zWYxzV=&E*)PdH5el~PX-ey-$^2jC44V1&Vk*qxivxqI^LnXb|*MEXts;H72HHlbeQ}o+nPl9NnkSJXMrgM zy+rdI$cE?G4NrBL{3feSBm6Efo$!ai41!*XGabl==h+R1RA4con7|T3ae<|TqXd>Ykif09fm`k{DIuj+5RMjD zNjOGe6``cSYQnJsYY3$T))LAHtRs{aSWhS?uz^rsU?ZV|z$QXP1BdH|8zrqxiLZ{h z8{W)4RgzslN2o0DJfVuf3xw(dFA{19yhNxa@G{{9fmaB%1zsg+bNL!Uo6FY;r^+gC z5Ka?#lW@AgTLf)C-*#a0WP2}rA-v--sUxesOQ z34BP$2Bj zqV2*y2e!uBmfKSMLtJ48z+c6PHvDUciRR!p1kJ&337Syf5j2S36E2lQIY7|U`U9bj zl=#ts{o4ZDbGFO)^rx6*fckUHGD1D*SPp%)y`T6cM%+*Q8sb`8^0ydK^7jze*^+<6 zh?0MXxZIZfD@K(3JH!>X%n(DgzdH;K9muiZjR+B&9i)4`Vq%+lxy|i zA3Ky$!N)^hr=_1bl(EYv4`poRsesKp0CJSiIJOns-b0V_S;w}5U|a7T$5OhNMyI=D zDGf$VdK}8ANza%U*o&lh%u>O=5o-nehionpyO9Bhu&wvNLm3qu6ti3ngAZZ5ks&e5 zJ6%H$VN=@tK^L&T^*uZ;vcRV4h>-i5L&J46@({MW9~E*RJ@=yzWt`+OF-zi&JCsp+ ze8eW)I6o5(Wt5&6@&HYa$pLShV=@dInG!PETX5c?jBQViSvE55P)6zL5o^6?9Lgv? zGh}l{Y)xiGtj)sgh)rp1WKPJ-%~68qhHP3nyX|=)qd7b5gZw5*7t?KRIO1W-{BVD0 z;&8GT1ian631xX<#Ck#&g*-qvvN&eh$dZV4BTGXz?T6jvvXIfRpn}UoMskB!I8Gjr zLB&eKg957@*rsP2T2idII^gX+mDf0y_RG8>W&5JFj-~xForvAYI>%BPXAOPP`jD}0 z@CL_8SE<@YLL#uqfz;LP+wNv_$fhB){9M3j8!SH`a(6wl7XmgHpKSX@$H~J|hnEQV z3%pFYPv8{?QcEN_&giQFb8~Jd)dzp{SdI} zV}ySs;~gb4fa|4?hJK0{^fZTwcX@se7NCPL|M97*gTVsq7ztt){1Pr$YMxH?vv2nP z8ZKCCb}f%uehU_C?`PKNWjFOZ7w9;qmu(OJ0Nc03j>A!yU2pGS(;ZArQw_V}n%;)~ z^?EH9s#ZDD3BU=~~NCR@jM zTq;I}Uq7z|(|oCkX{~r2y7^?QTMy5yQeWoaL%;Q$+3kOsgRi*NhsgnUFtZKaY*Jl5 zxZ8+OL!hyP{H!O<3QaPzPn+4MnDtH&c6)YY_#{>{XL_jk&{Xrt@c!pHk>M&jH!^%s zt%b9sp;WUap^?CO4(tipnKQ_&b$(=nja}eOYc|B#g^}Tp$y@}}+o4vNmXmmsDc(9W zdyAR9#LXsUq$-yao|NXI9RW97W|b=eIE~38fOPg%02^}il}?t{th$!)sH}b+;c{w*We&4rX7)rg zds}Aq)Wbc8Xqxmjo2y;c?Cpr2L)`B6<362!2LKh%&pN}@qmx^npVi#V-kF&_*UWZy zvq?3C)BII8fX3!-w=h5JW>YphGkb!Wy(cqU+sxjZnQdvdb021PJ6+r&n}s#a4Y>L4 zCJeQ-cje}>Dlmx(;;*Z8g=uO&94*IBymy1?jvk4YBi$c``8xtW78M+7?D4oD@QJ7( zF6}4dg21Pug1FwFjtc^xi3$!k_H0}bm_sy?No|{IsC!8G!bH!I@T()eL&Aro`-U{r zQ2&r-85-=!e$I6pK6yGcq&bF0II^Go+&0(HC`Yp5JVWC`nr~=QNVv0^8WNs?%nS*4 z?{h;!M?OC!d^%-eNEin!4he5pFAWKwn_d~x3PWo{T4`uwNcdLG^C96YEiZ?J?`pgr z5s2Z`$NKr;@gn$iQw-Y zC11(g*FQM0v9=?@gO21{?zIhx`D=_w&EI20CjJ>C{;tp8KzmuIv;W1k9mAME+xM?? z^UeaM(NiVb5u_dDXB}@gT)@pHy`;r1NEj?oh%iK;Frl|V5eNBMCz(wab+c|rQH-EH zOL0OU*}_o-{rXS|f_9Kc1JFbz{biM72)WY9mUOG+XPsqgaV(dYmF1-fUz^RC5~T@W z2$UhE1kpfbRQNPF`t1nuvu5(db@S0mUi z$$ZL}Fwm4ZOkditPO{jP7;?mYX$|g4hZ;2rL#1-Z0c@x)lhb%Sp{+nIg8o&W69`vH ziQ0r~1WqJeCvXzs27!|a?FCLD+$?Y^;Z}ju2pt7ZC)_S@2BDL{nS{;)XA$les6)6% zpf2G)fqH}o1nLvI2s9uh0u2cd3p64;BG8!dm_QT469P>MPYIk&ct)TZz-D3(31xG_ zAc1oTJq6Bnke_v{xnf$l*+fUWEeXd+wx0*^v*Ub%X2%5t&5jERnjIGrG&?RPXm+$B zXm+$FXm(se(CoOBpxM!e&{0m$WdzNR%L$qtZ3&tkR}eHi+7UE6t|Vx7Tt(3AxSF8Z zaScJU<644d$8`kFj_V1U9XAj(J8mRscC;sGcH9K8+2QU79OP#`WnzDen@#lg;8q9u zSuj0~ObZO#&H*>5N0NYdRw=q}KSU~iwy5Z-~@)b+$yxH>ya zPLgi=E(cPm2ZoP#M}{6bJ2G_0_e6$);JuMy*mqxOJ+Zy}Bg6I{hz#3%Fft5fxARW8Gwh$*5n;no>t}r`eNxI$Cz! zi*SrUZ$e3dK7?Zh`VvYB^dpoO=uapkFn~~2U?8EKz#u|-fx(0d0z(KD1%?tT3FHzg z3k)Mv5g1OWDlmdjO<*LUy1*zx4S~^wngU}8#|exj94|1AP)lGu;RJyRgxUfV2`36n za-b~+?s_JNW`F8&N@V!)!93V}=_IDQ<;e)Skfsqv3QQ-A5|}|4EijWXMqn0UtiWu- zIDt8Y@d9%R69ncFCJM|aOcGc?m@Kf6FhyVyAx~g2VXD9q!Zd-Ugy{my2r~qh6J`pm zAj}e2Nti9LiZDlDHDRv68p1q*wS@Ts>j(=3))N*AY#=NW*hp9`u!*n)VE(u#Kr`V5 zE?g?5UnDFOc!{uF;AO%JfmaAC1zshr0+{y_0J_IFxNxUV9 zlE9~gmu28+hK>^P!&SdOpeXJkO_kzQyx@JkLpI>N5$`TAw`6w|c(A z^S?Y#707Jo1WfC8&hWgA=j}Xy((@e8Cwo4{^Orn-&GV1w<{R+^O&!|cuE3;S>OgKT zo}XsLh@o^kMm$3;5F?(V7K{-WaG@CSB(-pic$QiuMm$X|8Y7;k7K;&2REx)mXR1fV zi19^<81Y>7=os;2^_Up(Y_(*Jc)EIQjCj6UDn>kEEgd7Cv6hJucTQzv#9c?Z7&jU$ zA0vJOqe6`M<&ugK4$CoEDMmcwtsEoT$SN`7=BR3nc+y)fM%;H+j}bSXHDbi`-kLGu ziSKbS;?pe0$B6eXYsHB7a88I3?@iW@5pPbO7$e@9IVncGJ$W*)5xS;y_GC=E_QCUc zbn_!5nD(x_5%{T!j-Y{xdA0x&M8)C#8OB-XvxL{L^7(Z-|5l;c0ixCav^D&}< zd?7|OkT1rF2J)pC(LlZ&BO1t8VnhS^YK&+gUyBh9~t`hz9bl7|}q! z9U~gZcVa{X`EHD8Ah*Pb26AhRXdvH<5e?+~F|Ick+y_9t;I?5}FT}q*PZi4e$(Yvi zbv*Cn`Ga)x)Cbev#X5S7smVhz;tEb;#1-5%MqI%U$A~MqTa37ZABhoH@S`!}3Vtj` zT)~gWh%5Ms7^j-k_$1Jt7V~CtTmaYC(=p=udL~9(U(d#f>nkTlTwmQ|#P!u9MqFP# zW5o5cPTvkJ3 z#AP)!MqF08G2*fs79%dJ;W4f?)f)lS>Wz#GV7M_VM*NK3Xs(sc9)oGU#HM*Z-ScIh zFZX<%=j%P+=y|GeX8VncxZ0+(TVh)Gd!6SUJ-^%Y9J)y}OxsHsH=b|in&a#d5^m{w zI>IAdJaz5mpc__u16OlzN6F3jkXbsr4?s_7U$;=oOgLhXwRH4sCcy=+Q?wO74)O9qB;MCECYPj*@Go%xDKv2F>M|fL=!%Gd7?%dKnrQ z5}K0nA)z6e;3(;*&n+Fu?b0Os$5tm1ZG%9VPnq)+`6I8oJckB;6l|*mE2vx0#9=nCn1R z#Er!~N6CFsr}+*f8feKEgoNZ@NRkTz5n4pErvbFsQSyLneTf5kma`OX?NXRtd&{`o zZeys~#`2Kx4%3Q|ka;UZLSnB9=+zuUt3$%A(VCEOW3-l}Clhxe>tdX2s=gj*t8Sjk z6gAV@vK7X(dQs1dd0yP}MxHnJys78SJwM0u7M@?{`SqSp@qD)DOFZA<`A?qz?D;RA z|LJ+vVwvNufoVMtXM5hl^Om0Hc)rH-4W4iD{5{VL7SHUr5TLzm=QnuX)$_+ZAMW`$&nJ04*YhQwr%Gf3dkLnst;oT28`F*HW3T17 z!n?FOSMl?JFW5nZ+ zK{4X-$KV+8_+vR-oeq4+g=8caLH*FJQ#Gqtij2MMXiV-($lVikyX-bT^Y0HZ-&*0P;(VtC= z5k1=U7%>o?5hDg-Gh@V9bXJV$wr9tPPI^v^==0~sh(X}I7%}9UA0q}`3u46G+rk)e z_qHfT46_!;h`YBXG2-rRX^eO}vMk1Brpa0k)TZn?Olx29ljnbUe)7?o@^vun`ZUiw z9+UBBF|FIr@qC`=^F3eW`4Z2UdH%QOCzs4@zYeCgKJ7j4;`sp2mw5h`=Q}+A)$`P` zneDg5v>w-0o8Ko z+7Q!vpp86l?Rh)TAN4%P^Btal;rT(&Q>8QeEsbg2ZyC?e_dLh*zMl83e!u5kJn!ats%+*w-;8NJ z&$oDfyXQHczvlTC&+|RcDVN#)DopG4*LeOv&r{_yFp!!hQt=@?^9jS*waX)$7q zIXy;#`UzcwHVN2Cpk(#Nc&hj2OJG ziV=g?)iGl5x+X>pUf0Hm!RxvhF?d}cBL=Sj2FYSmM`vk3D3)VUe5Cho>%m|k>`y)Z|Zq7&s%xk&hz%3=XpNI^Ld_c z^E}`4-JYi^XO6curuF=^^L)DJOFaMG^Hi10c8X(Kx09-x@nV=(FYb9`&zpFDvFGhP zzu)sNp67Z#-19k}&-Hw@=c#I$dKSU7*0ZSR#XUdD^TwW^?RhiLn|pq)=Pf*M?Rh)T z+k4*8^Uj{%<$1Q}_jo?k^IXq|dp^SRah~USKF{+V)idYqcTBsu*T{G&OskjnyqV|c zIzQZqxk>V>X~jP}!d5(;-QL^b61PLsNG$dIInRIe{9n(<*UB7F$~*&i4aS3*)&uS0 zc{k5_Kj!(< zp6AldpRInt?5hn&NTb){DaUy+;wi`ZG2$u51u^0&$AvNCDaS=I;wi_)G2$sls~GW= zqjijU%5h1Ic*=2UjCjh?CPqBvxGY9I<+waXJmqK`Bc5_x5hI>*w2Ki>Ij)QmPdToN z5uX9MI!3%%eNBvbv-;W?@n-dPG2%U`>tn>bQa8l7#^8-Ht~J;`M!aElQ;c}m`sNrn z7`!FMjRtRx5$|Pnh;g%NqdEfhI-P)N*FHR$@iv%Nzryo=o)7gr&+{Fg@AmwF=RbO$ z>XO;-Z+$cSP4&z8M}s^cobh6q)_NXTobjJAt$xt+zdZlj`QbW>rpfE3qi9j_NFS~I z>+LYLBvZj!OEVR$hiMH+eb3u@ezoV_x9qM@A%JX)fzvOvpOJ+O2U|P46 z+M4l`Fs*(H-CR1DZi5CJAH_c~srMN3A8l!ec)?g*(2)yD$QpKmS%^mLw*PA(8nfH~ zuZ3vT?)bkJqH*i=e=WqL+&i&QQ>ZJZ^)R2Ln>!_LKn}CdT0NQ#@q%@_U?UgEVaghM zn498-b}e1FIbLY@WftNbJQpu?Yc4iN@;nymk$jD57s&TAele!ipY!|!&v$tKv*)Sz zGuycy)4H9Go`qknzLBCpDfS_M3E=bU?78fF1CmStH z(61I3A?R0&ixTv!#l;Bv)#BoWjqUO^G@LO^Lb$ zO^JF0O^NyhO^F5sO^JpCO^HSXO^LwHxo2yw-7XFw-PjH9S9n6Xyp15G;;k2h}_}&y}HTU1yiX~ zm5%H-%zU_rd(xB`K+u#JNYIoRM9`ENOwg1VLeP{LO3;+ZC1^?vBWOwtCumBHAZSXA zBxp*EB4|pCCTL2GA!tgBC1^^FBWOyDCumAcAZSWVB-oTlXHNoX+c=pEH5;Z7Y&Mvm zGw@1J<3fAIrn9Ge3ukhn24WV$1|pq3+bcbn3-y%GBj_ogPta4ofM8E~I(s2N4`dM+ z>e*gQ(6haSpl5q2LC^Lwf}ZW=1U=g;2zs_x67+1ZBIpIUnxGfp8iJnkwFEuo>i~LO z>$%Wgd+F>A-olMss8`1(f?ge)2^y5=2zqrqPtdF51%h53FA{91(%CNow08o6%?8oBQX8oBQYh}_{iwR*|Brc-<3h�d+>@rn4+Kq#9|@WgKM^z~ekN#2 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®|a+?jOEe(-?~ z9rDec@Wc59x;~sF15qGtzDSi^hnG%x>4ul5@REm@m+|rzUf#jWR=m8Amk;r>4KMk4 zF~7%^O3W|Yq!RNpHmT%$yqJ%or;=mM2~3W|OMSfDjF(&Saywq`!^^XH8HSfv@UjIj z=5xcT4TU4co~S75qO!5mzj8Z2QPc^@-<%0H>V(JjhB1y(giPl z@v;~%EAX-&FB|c)886S{_%&*m`=)Emc}>EqC75 zW6%F7g^~xZD)8S5|9?J9WpnQwdr@AkysmjCkGo>dwM*)+DX`}1CFg8C)f2qXR93jdv@|578<^8I%`{C7S4cRl=fJ^a^;{x@{^Z@i?p1OIi3|8+Y_mzL==#mscsRFPwPX8%yGc%fr| zC@<3$jxy5~Wx7%cGhJDxs~l~ntIBk>W6X4QnXXaNOxKj@sK<<4P?4u zWi#DKrW;o=(@kW$X;m|QwoEsxW~Q6V^f}ed^tm$KqK27nnI$vlWz{ru=j+@BS;v{V z3w7?ItmDnx#X8q2tCpE-t#g-TonYoJ)wwoVwawgRI(K>2iDs^?&Rvmpl9_9#b5~}a zZ04@gxvR5IF>}}G+_hP!nmO~7&W7mvtkcZg4LWyY*6C)hz0Tc~b%vR{S?6xaI@8SE zs&gH(&N6cyb?&yTI%e*6ox3Beu9-8B0PP;`%&KSRI_unBS@q4_-8z?@)xgZ%qjUFW zH8gYg>D>KUjm+EwI`?2!V>8!9=N`&xV&)Q^>zdWn%ss4g-LlR$bC2lUqgl<&++#ZT zcvf>W_k_+pnRSktGY=?jJ)h1x*UUYmbI)eAFmo-_8ozYQEHi6iAblQY%`e2+ z*^AQWW7hl}oSkizz5ui4x8LmSCFu(>Ykug>&bCQkgjw^eZg%$a^u?GpKjCI)uSmDT zY&)I3GTj=p=EvFW(yP;#VAlK+o1MKjeJN(m&#u|o>(gy8dxOs2n7$0N?REAh^NiQb znun&g@Ga@Km^F`2?QDni6`1X)v$v(&Vb-)9cIh4IE6war1+LCII^DgPeM0>I01g*g AMF0Q* literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/idna/codec.py b/.venv/Lib/site-packages/idna/codec.py new file mode 100644 index 0000000..913abfd --- /dev/null +++ b/.venv/Lib/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, + incrementalencoder=IncrementalEncoder, + incrementaldecoder=IncrementalDecoder, + streamwriter=StreamWriter, + streamreader=StreamReader, + ) + + +codecs.register(search_function) diff --git a/.venv/Lib/site-packages/idna/compat.py b/.venv/Lib/site-packages/idna/compat.py new file mode 100644 index 0000000..1df9f2a --- /dev/null +++ b/.venv/Lib/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/.venv/Lib/site-packages/idna/core.py b/.venv/Lib/site-packages/idna/core.py new file mode 100644 index 0000000..9115f12 --- /dev/null +++ b/.venv/Lib/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 = 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/.venv/Lib/site-packages/idna/idnadata.py b/.venv/Lib/site-packages/idna/idnadata.py new file mode 100644 index 0000000..4be6004 --- /dev/null +++ b/.venv/Lib/site-packages/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/.venv/Lib/site-packages/idna/intranges.py b/.venv/Lib/site-packages/idna/intranges.py new file mode 100644 index 0000000..7bfaa8d --- /dev/null +++ b/.venv/Lib/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/.venv/Lib/site-packages/idna/package_data.py b/.venv/Lib/site-packages/idna/package_data.py new file mode 100644 index 0000000..514ff7e --- /dev/null +++ b/.venv/Lib/site-packages/idna/package_data.py @@ -0,0 +1 @@ +__version__ = "3.10" diff --git a/.venv/Lib/site-packages/idna/py.typed b/.venv/Lib/site-packages/idna/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/idna/uts46data.py b/.venv/Lib/site-packages/idna/uts46data.py new file mode 100644 index 0000000..eb89432 --- /dev/null +++ b/.venv/Lib/site-packages/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/.venv/Lib/site-packages/loguru-0.7.3.dist-info/INSTALLER b/.venv/Lib/site-packages/loguru-0.7.3.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/loguru-0.7.3.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/loguru-0.7.3.dist-info/METADATA b/.venv/Lib/site-packages/loguru-0.7.3.dist-info/METADATA new file mode 100644 index 0000000..09505ab --- /dev/null +++ b/.venv/Lib/site-packages/loguru-0.7.3.dist-info/METADATA @@ -0,0 +1,462 @@ +Metadata-Version: 2.3 +Name: loguru +Version: 0.7.3 +Summary: Python logging made (stupidly) simple +Keywords: loguru,logging,logger,log +Author-email: Delgan +Requires-Python: >=3.5,<4.0 +Description-Content-Type: text/markdown +Classifier: Development Status :: 5 - Production/Stable +Classifier: Topic :: System :: Logging +Classifier: Intended Audience :: Developers +Classifier: Natural Language :: English +Classifier: License :: OSI Approved :: MIT License +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +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 :: 3 :: Only +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Programming Language :: Python :: Implementation :: CPython +Requires-Dist: colorama>=0.3.4 ; sys_platform=='win32' +Requires-Dist: aiocontextvars>=0.2.0 ; python_version<'3.7' +Requires-Dist: win32-setctime>=1.0.0 ; sys_platform=='win32' +Requires-Dist: pre-commit==4.0.1 ; extra == "dev" and ( python_version>='3.9') +Requires-Dist: tox==3.27.1 ; extra == "dev" and ( python_version<'3.8') +Requires-Dist: tox==4.23.2 ; extra == "dev" and ( python_version>='3.8') +Requires-Dist: pytest==6.1.2 ; extra == "dev" and ( python_version<'3.8') +Requires-Dist: pytest==8.3.2 ; extra == "dev" and ( python_version>='3.8') +Requires-Dist: pytest-cov==2.12.1 ; extra == "dev" and ( python_version<'3.8') +Requires-Dist: pytest-cov==5.0.0 ; extra == "dev" and ( python_version>='3.8' and python_version<'3.9') +Requires-Dist: pytest-cov==6.0.0 ; extra == "dev" and ( python_version>='3.9') +Requires-Dist: pytest-mypy-plugins==1.9.3 ; extra == "dev" and ( python_version>='3.6' and python_version<'3.8') +Requires-Dist: pytest-mypy-plugins==3.1.0 ; extra == "dev" and ( python_version>='3.8') +Requires-Dist: colorama==0.4.5 ; extra == "dev" and ( python_version<'3.8') +Requires-Dist: colorama==0.4.6 ; extra == "dev" and ( python_version>='3.8') +Requires-Dist: freezegun==1.1.0 ; extra == "dev" and ( python_version<'3.8') +Requires-Dist: freezegun==1.5.0 ; extra == "dev" and ( python_version>='3.8') +Requires-Dist: exceptiongroup==1.1.3 ; extra == "dev" and ( python_version>='3.7' and python_version<'3.11') +Requires-Dist: mypy==v0.910 ; extra == "dev" and ( python_version<'3.6') +Requires-Dist: mypy==v0.971 ; extra == "dev" and ( python_version>='3.6' and python_version<'3.7') +Requires-Dist: mypy==v1.4.1 ; extra == "dev" and ( python_version>='3.7' and python_version<'3.8') +Requires-Dist: mypy==v1.13.0 ; extra == "dev" and ( python_version>='3.8') +Requires-Dist: Sphinx==8.1.3 ; extra == "dev" and ( python_version>='3.11') +Requires-Dist: sphinx-rtd-theme==3.0.2 ; extra == "dev" and ( python_version>='3.11') +Requires-Dist: myst-parser==4.0.0 ; extra == "dev" and ( python_version>='3.11') +Requires-Dist: build==1.2.2 ; extra == "dev" and ( python_version>='3.11') +Requires-Dist: twine==6.0.1 ; extra == "dev" and ( python_version>='3.11') +Project-URL: Changelog, https://github.com/Delgan/loguru/blob/master/CHANGELOG.rst +Project-URL: Documentation, https://loguru.readthedocs.io/en/stable/index.html +Project-URL: Homepage, https://github.com/Delgan/loguru +Provides-Extra: dev + + +

    + Pypi version + Python versions + Documentation + Build status + Coverage + Code quality + License +

    +

    + + Loguru logo + +

    + +______________________________________________________________________ + +**Loguru** is a library which aims to bring enjoyable logging in Python. + +Did you ever feel lazy about configuring a logger and used `print()` instead?... I did, yet logging is fundamental to every application and eases the process of debugging. Using **Loguru** you have no excuse not to use logging from the start, this is as simple as `from loguru import logger`. + +Also, this library is intended to make Python logging less painful by adding a bunch of useful functionalities that solve caveats of the standard loggers. Using logs in your application should be an automatism, **Loguru** tries to make it both pleasant and powerful. + + + +## Installation + +``` +pip install loguru +``` + +## Features + +- [Ready to use out of the box without boilerplate](#ready-to-use-out-of-the-box-without-boilerplate) +- [No Handler, no Formatter, no Filter: one function to rule them all](#no-handler-no-formatter-no-filter-one-function-to-rule-them-all) +- [Easier file logging with rotation / retention / compression](#easier-file-logging-with-rotation--retention--compression) +- [Modern string formatting using braces style](#modern-string-formatting-using-braces-style) +- [Exceptions catching within threads or main](#exceptions-catching-within-threads-or-main) +- [Pretty logging with colors](#pretty-logging-with-colors) +- [Asynchronous, Thread-safe, Multiprocess-safe](#asynchronous-thread-safe-multiprocess-safe) +- [Fully descriptive exceptions](#fully-descriptive-exceptions) +- [Structured logging as needed](#structured-logging-as-needed) +- [Lazy evaluation of expensive functions](#lazy-evaluation-of-expensive-functions) +- [Customizable levels](#customizable-levels) +- [Better datetime handling](#better-datetime-handling) +- [Suitable for scripts and libraries](#suitable-for-scripts-and-libraries) +- [Entirely compatible with standard logging](#entirely-compatible-with-standard-logging) +- [Personalizable defaults through environment variables](#personalizable-defaults-through-environment-variables) +- [Convenient parser](#convenient-parser) +- [Exhaustive notifier](#exhaustive-notifier) +- [10x faster than built-in logging](#10x-faster-than-built-in-logging) + +## Take the tour + +### Ready to use out of the box without boilerplate + +The main concept of Loguru is that **there is one and only one** [`logger`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger). + +For convenience, it is pre-configured and outputs to `stderr` to begin with (but that's entirely configurable). + +```python +from loguru import logger + +logger.debug("That's it, beautiful and simple logging!") +``` + +The [`logger`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger) is just an interface which dispatches log messages to configured handlers. Simple, right? + +### No Handler, no Formatter, no Filter: one function to rule them all + +How to add a handler? How to set up logs formatting? How to filter messages? How to set level? + +One answer: the [`add()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.add) function. + +```python +logger.add(sys.stderr, format="{time} {level} {message}", filter="my_module", level="INFO") +``` + +This function should be used to register [sinks](https://loguru.readthedocs.io/en/stable/api/logger.html#sink) which are responsible for managing [log messages](https://loguru.readthedocs.io/en/stable/api/logger.html#message) contextualized with a [record dict](https://loguru.readthedocs.io/en/stable/api/logger.html#record). A sink can take many forms: a simple function, a string path, a file-like object, a coroutine function or a built-in Handler. + +Note that you may also a previously added handler by using the identifier returned while adding it. This is particularly useful if you want to supersede the default `stderr` handler: just call [`logger.remove()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.remove) to make a fresh start. + +### Easier file logging with rotation / retention / compression + +If you want to send logged messages to a file, you just have to use a string path as the sink. It can be automatically timed too for convenience: + +```python +logger.add("file_{time}.log") +``` + +It is also [easily configurable](https://loguru.readthedocs.io/en/stable/api/logger.html#file) if you need rotating logger, if you want to remove older logs, or if you wish to compress your files at closure. + +```python +logger.add("file_1.log", rotation="500 MB") # Automatically rotate too big file +logger.add("file_2.log", rotation="12:00") # New file is created each day at noon +logger.add("file_3.log", rotation="1 week") # Once the file is too old, it's rotated + +logger.add("file_X.log", retention="10 days") # Cleanup after some time + +logger.add("file_Y.log", compression="zip") # Save some loved space +``` + +### Modern string formatting using braces style + +Loguru favors the much more elegant and powerful `{}` formatting over `%`, logging functions are actually equivalent to `str.format()`. + +```python +logger.info("If you're using Python {}, prefer {feature} of course!", 3.6, feature="f-strings") +``` + +### Exceptions catching within threads or main + +Have you ever seen your program crashing unexpectedly without seeing anything in the log file? Did you ever notice that exceptions occurring in threads were not logged? This can be solved using the [`catch()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.catch) decorator / context manager which ensures that any error is correctly propagated to the [`logger`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger). + +```python +@logger.catch +def my_function(x, y, z): + # An error? It's caught anyway! + return 1 / (x + y + z) +``` + +### Pretty logging with colors + +Loguru automatically adds colors to your logs if your terminal is compatible. You can define your favorite style by using [markup tags](https://loguru.readthedocs.io/en/stable/api/logger.html#color) in the sink format. + +```python +logger.add(sys.stdout, colorize=True, format="{time} {message}") +``` + +### Asynchronous, Thread-safe, Multiprocess-safe + +All sinks added to the [`logger`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger) are thread-safe by default. They are not multiprocess-safe, but you can `enqueue` the messages to ensure logs integrity. This same argument can also be used if you want async logging. + +```python +logger.add("somefile.log", enqueue=True) +``` + +Coroutine functions used as sinks are also supported and should be awaited with [`complete()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.complete). + +### Fully descriptive exceptions + +Logging exceptions that occur in your code is important to track bugs, but it's quite useless if you don't know why it failed. Loguru helps you identify problems by allowing the entire stack trace to be displayed, including values of variables (thanks [`better_exceptions`](https://github.com/Qix-/better-exceptions) for this!). + +The code: + +```python +# Caution, "diagnose=True" is the default and may leak sensitive data in prod +logger.add("out.log", backtrace=True, diagnose=True) + +def func(a, b): + return a / b + +def nested(c): + try: + func(5, c) + except ZeroDivisionError: + logger.exception("What?!") + +nested(0) +``` + +Would result in: + +```none +2018-07-17 01:38:43.975 | ERROR | __main__:nested:10 - What?! +Traceback (most recent call last): + + File "test.py", line 12, in + nested(0) + └ + +> File "test.py", line 8, in nested + func(5, c) + │ └ 0 + └ + + File "test.py", line 4, in func + return a / b + │ └ 0 + └ 5 + +ZeroDivisionError: division by zero +``` + +Note that this feature won't work on default Python REPL due to unavailable frame data. + +See also: [Security considerations when using Loguru](https://loguru.readthedocs.io/en/stable/resources/recipes.html#security-considerations-when-using-loguru). + +### Structured logging as needed + +Want your logs to be serialized for easier parsing or to pass them around? Using the `serialize` argument, each log message will be converted to a JSON string before being sent to the configured sink. + +```python +logger.add(custom_sink_function, serialize=True) +``` + +Using [`bind()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.bind) you can contextualize your logger messages by modifying the `extra` record attribute. + +```python +logger.add("file.log", format="{extra[ip]} {extra[user]} {message}") +context_logger = logger.bind(ip="192.168.0.1", user="someone") +context_logger.info("Contextualize your logger easily") +context_logger.bind(user="someone_else").info("Inline binding of extra attribute") +context_logger.info("Use kwargs to add context during formatting: {user}", user="anybody") +``` + +It is possible to modify a context-local state temporarily with [`contextualize()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.contextualize): + +```python +with logger.contextualize(task=task_id): + do_something() + logger.info("End of task") +``` + +You can also have more fine-grained control over your logs by combining [`bind()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.bind) and `filter`: + +```python +logger.add("special.log", filter=lambda record: "special" in record["extra"]) +logger.debug("This message is not logged to the file") +logger.bind(special=True).info("This message, though, is logged to the file!") +``` + +Finally, the [`patch()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.patch) method allows dynamic values to be attached to the record dict of each new message: + +```python +logger.add(sys.stderr, format="{extra[utc]} {message}") +logger = logger.patch(lambda record: record["extra"].update(utc=datetime.utcnow())) +``` + +### Lazy evaluation of expensive functions + +Sometime you would like to log verbose information without performance penalty in production, you can use the [`opt()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.opt) method to achieve this. + +```python +logger.opt(lazy=True).debug("If sink level <= DEBUG: {x}", x=lambda: expensive_function(2**64)) + +# By the way, "opt()" serves many usages +logger.opt(exception=True).info("Error stacktrace added to the log message (tuple accepted too)") +logger.opt(colors=True).info("Per message colors") +logger.opt(record=True).info("Display values from the record (eg. {record[thread]})") +logger.opt(raw=True).info("Bypass sink formatting\n") +logger.opt(depth=1).info("Use parent stack context (useful within wrapped functions)") +logger.opt(capture=False).info("Keyword arguments not added to {dest} dict", dest="extra") +``` + +### Customizable levels + +Loguru comes with all standard [logging levels](https://loguru.readthedocs.io/en/stable/api/logger.html#levels) to which [`trace()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.trace) and [`success()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.success) are added. Do you need more? Then, just create it by using the [`level()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.level) function. + +```python +new_level = logger.level("SNAKY", no=38, color="", icon="🐍") + +logger.log("SNAKY", "Here we go!") +``` + +### Better datetime handling + +The standard logging is bloated with arguments like `datefmt` or `msecs`, `%(asctime)s` and `%(created)s`, naive datetimes without timezone information, not intuitive formatting, etc. Loguru [fixes it](https://loguru.readthedocs.io/en/stable/api/logger.html#time): + +```python +logger.add("file.log", format="{time:YYYY-MM-DD at HH:mm:ss} | {level} | {message}") +``` + +### Suitable for scripts and libraries + +Using the logger in your scripts is easy, and you can [`configure()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.configure) it at start. To use Loguru from inside a library, remember to never call [`add()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.add) but use [`disable()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.disable) instead so logging functions become no-op. If a developer wishes to see your library's logs, they can [`enable()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.enable) it again. + +```python +# For scripts +config = { + "handlers": [ + {"sink": sys.stdout, "format": "{time} - {message}"}, + {"sink": "file.log", "serialize": True}, + ], + "extra": {"user": "someone"} +} +logger.configure(**config) + +# For libraries, should be your library's `__name__` +logger.disable("my_library") +logger.info("No matter added sinks, this message is not displayed") + +# In your application, enable the logger in the library +logger.enable("my_library") +logger.info("This message however is propagated to the sinks") +``` + +For additional convenience, you can also use the [`loguru-config`](https://github.com/erezinman/loguru-config) library to setup the `logger` directly from a configuration file. + +### Entirely compatible with standard logging + +Wish to use built-in logging `Handler` as a Loguru sink? + +```python +handler = logging.handlers.SysLogHandler(address=('localhost', 514)) +logger.add(handler) +``` + +Need to propagate Loguru messages to standard `logging`? + +```python +class PropagateHandler(logging.Handler): + def emit(self, record: logging.LogRecord) -> None: + logging.getLogger(record.name).handle(record) + +logger.add(PropagateHandler(), format="{message}") +``` + +Want to intercept standard `logging` messages toward your Loguru sinks? + +```python +class InterceptHandler(logging.Handler): + def emit(self, record: logging.LogRecord) -> None: + # Get corresponding Loguru level if it exists. + level: str | int + try: + level = logger.level(record.levelname).name + except ValueError: + level = record.levelno + + # Find caller from where originated the logged message. + frame, depth = inspect.currentframe(), 0 + while frame and (depth == 0 or frame.f_code.co_filename == logging.__file__): + frame = frame.f_back + depth += 1 + + logger.opt(depth=depth, exception=record.exc_info).log(level, record.getMessage()) + +logging.basicConfig(handlers=[InterceptHandler()], level=0, force=True) +``` + +### Personalizable defaults through environment variables + +Don't like the default logger formatting? Would prefer another `DEBUG` color? [No problem](https://loguru.readthedocs.io/en/stable/api/logger.html#env): + +```bash +# Linux / OSX +export LOGURU_FORMAT="{time} | {message}" + +# Windows +setx LOGURU_DEBUG_COLOR "" +``` + +### Convenient parser + +It is often useful to extract specific information from generated logs, this is why Loguru provides a [`parse()`](https://loguru.readthedocs.io/en/stable/api/logger.html#loguru._logger.Logger.parse) method which helps to deal with logs and regexes. + +```python +pattern = r"(?P

    + + Loguru logo + + + +

mKFxvJ3ED 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/__pycache__/utils.cpython-312.pyc b/.venv/Lib/site-packages/click/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..749177905d6d5f36913de875cc2cfff1704f775a GIT binary patch literal 26383 zcmc(He{d96erNam{-xi)KnQ3+LK-2BY=dpkVjLk52xEaQVPkjbq#v`=JosizVG|{z5kJy=M(UFPv7kyJS7N!OFzt~(1@%~I|N}? zkOf(c3EliHc8lz{t=q=l_HGB>wwQCs)$I}~k3Hrd@^pJx+<~~a+l#nUcEx-{{%${u zyAcm`2Uy&LcwToNi+d5z@6Km&AL0ew1uX7Iys*2F#RG^Jbr-RC9^%E_#VnqWcu98& zix(hX+Fi=xg|V`s^6qj`P#l9HbBLL@TF%C?se7|cP&N*9csW-n8*j-8C$28`8F0X}i6G`A=?>cc8TnvyIFaG9MuhdF+rgk&d=aKiICn0kV(bjRf0eOGX%#nFxjT-xGtgR5@|C-)3 zVU`}lANA^=HP3zd^5f|5W9VnQ+#o+8?`5@Y>vPHbkp8%QLVgl`dkU#f8(%!~etda? z!Oj7|PO}9&dr`}C@>jle-VQ$GtB0>8Al@ZEgZlT$68m@P9lQK2$_!@a&5S90oqhrR zYQf)O)<4H!%>15t^PGJ?x%G8d_tT?d@Z?YFV@FWb^GAl|a8l{HtcHh&6%{GI=M(Zs zOz9dOR`4sYOASYq3*pE`O86;lVx*S#$Vy*$B$n(+Dp!&{T2fY2D!VZ~F_J`jNl#xi zF85rB#>46;+KMJwQ^nztWP&x_)0a?t!f`E%%=tz(EvYKuAq^@1#IO=aEA$&bi?o5n zNKB@L=&)JJx8_&C=$Bc8{pEHVZJDZQiP$BjCz6PvL1PfQcv=@<)E)8gkfOU(B{`zT zBL=!+lL!85+5G;IZ?eOG^CG`IFHL=QS)x<1m&u+^=Zo zBe7`YV$(=68q-3;h4)K^;hK3?WbL>S+xgCG2MDTu7oCRjJ z2~)O|5EWA5`{J*Qox(05Gqh?!wTr?l!l-arxMF`rxGa7k5>R@Nnw<#RRjN;w5a!bZoO0?o%QdL+D^Efwy)jWPGYdKCKbK=MzHOX7?6-T2e7rx=>O# zU%psUw-BiNe5GL1&jit1v>Yg0E+|Pm5&c37pv14Z{lc5x3j1$~751P*7n8c@6q}oH zOfA88mHHC2snmp8gFvIT>XmrkJZ6{FI;8HP&onL64VTkdI(;QA;B}*!z5aN|pVt3T z{SRLFqsG6d)Cc)OpmMHue&3S6ZoyHf5|HW6OX1jvvIc@^!l@Ih-$yVjB&}VT5|S3& zm{6crdudPR*l!uA8T6o{b&t6l%^lk*B=gKHDIt@JrDg0NeZ$h0i4SQ_7G;~+r-JV8u#mNRT+)}9S7aIFRDf3 zS~47uD7y2)Xi@>h%1R_5E4p19)%3D{CD|8^DTpVPAtjD4s7Vi;iAO2ZQB_T-$eARx z62u5NS}~S#D11>N?5ffV62GUtj9^0eiMwdJ=AE+J?(GCx`<6>K%^sXN_`dy)bYM|B zuq1tDspQ~7;NSz75Ga@&d9!)JQTF)*r%+f$0B2^Oci-5&RI>Mzz}~bSsb6SCsQWi| zwg|$;45V} zTa(>mfQ)fx2F^0yjtH-Up*)XXkGsa*sqFG@vwX@WJ1-s)gfWa`46rxuNI6m>rKmPh zh_|HNGH07StVf$=@1WNlbLNeH+EJ66YN@o~Hi8;D1y&zMqls@FPq|V~ni<49PCiFFs6iJ! zs*Altx+sm=L!nU639Jl8Mx~MHcEF|XRpKK~X?R9Z9f{5^N+ob3~LB{2PT$MmZU1-m94$dgxe?ZniH zH&0F+{mc(4P=q8;-sB5cuT1az#9gsmST-G=zA){bblxi|ojAEtR62d;?aI0E%(jUW zKPjo2JM-5iyQbWe;^e+%Pw6}Mxg+25&cAS@=)E(GoAxYv_Dlxu`77q?Kk-+88YsHw zFPOH0OVGal>~cx@?Eabkb4TZE=UZ-w?;V}%SSs1`Nnj6UZ(j1(+}Lqr>}C@RrOSlU z>hva|u;kj6sVj5NH-CA-vkjee7JajI&iVF7yGSm6NM9X;)$3ak1f_)Pq(8{_xo3doU~*ip z`6*>({jv>mCg}yr*oYc(w3Jg%VT_1037bZ3!Ajk8GCVfg1~NJJe_Es%;u6tJ37hbu zCdHx`6<`ik=^u%ORsQ9|2;(2+grZ6DL=wzpEH)~Uc;ch|njBCz=7U%T>1GK0=a3>@ z2y4-Z6d6z=Xh8|9C=GhADT);BqvEU@>I4ZR5+RTw1-M0GEfNwyUZAm%By|l$H3|Pm zGzGno(1b)Rn9&^&d#fsqeI%)imv+q0`~yz)6hv9H{=Qx?_m=2#>`z zxFFpnRB#v&CWfMs2%$yup|~A?tGn5@$na#jIQf)CkyApCMbA@UnR}=X_JC3dJr3)a z1HUpf7Sy}PYCRESd}a=(^4W@vZow3jod_qQJ=*FB5u*qQ7Gh6 zwo8IqnIyiSJyhQ0I9V|m zy&h1WXtJkgtjOF5Av5WhkXL&H!G!RjP^heWck}hl^ZS=JH%vO-@-CNdVy{gSUU|#q zRe1T0*QcHU{sZk_J1})%&i;vi%Sv$Ht+O8{KRWxvOH09*76ZE{kGyqky6Z<}yYCeg zPs>wZec%y_%BIiGC6@}T?-bTA7S`V`Y*;R@qVcwR8&VP81E=bT|0sa1yNV8T|ghroN09Yn2H*k|FH)dwPs~n7h)f zxwBH=LOG2(Iw7nSlusvTM`uRg{_6aZrGnssC&;NwHp^;>Hq$7>7+Sp7KUd3=nQbEE zPzhP=RVTnd!=iybwl+Ka*0CtV*j=itdyf;tnlDSoPZ4+6vL6VW42mJ z7Y_xUYA5Q{9gs~_y?`)XI07hdFz>gOTzresF2$!G#^qeE8x=jz9N)?EUboKisiU zaB{(Oa^pN(f zeGMGXxa~FDWzp1P1YKjlcM6c9Wyl|BSu|P8N#v-KWCYSAS){g*hNArgpq}AqOu8IR z4ltTTm?7PDPXMD@WU|x2|O5JK+Ujj287q+BpssL|Y0Ul<~0$Yw0h!XvcLzKIM5{!ROYK%ub(mP;yT zpPqSovLkJCd!JpYZdxuZo%POm=k~pO;QE1i`8z}J4c+Sc!*joX?uVs+wdF6iJh0np z@)rX;CJ#?LZWr!I=L;oeK-O+B{gd9$ANYmBik}H~@3VIUjh_{7nLF}s`}Ou4E#Euw z!HL_&Pk;ErLg3Iprrr4dg+}7dziaWeGzuR#dJjwXkDsbJyv6?gEl$MOXlV$iGHm=J zA`eAnTL6IgzW(_#d@Ty2B9zy*u|2Is{5ZUgKy(5ZMW8`QrvYr41Pnwx(`9J;LLJap z5rR_5CZdKBWT7CIIF@fsJfow(LwU9#m=K7Hanu8C*|lR+$F4m;_53$ZrR_ps`$pVi z4g3%aKWyM?5e9Byabz@}4D(d6guZ* zY;>$@?Ub(lN<-C1p$U1_1JJ(XulmGaMKcVc^cyE>b~(9U16D+>7+BG+rP(!z_6HkQ z6*_AO+<*X3mSU?TR@#3=`BlQ5AT0$YlYX|4;C8P>dXlhlK%_^EDdTio@J8tqdTDmO~lo`R7ou*I4&d- zG4(7(?Je<9mFzs~1^Q`gKgGt%VV{;!CC*rPkU31xI~>-Oqo(>^B?7Hpq0gRn44zCc zx(oGnf}i{R(%Jf%`nk@TrnHw*d_qz2tZ&9Q zw|Ax>?WdFg80}T6F8!3~te>~11-x#E-*bN8T%~B*Wp_R=&h1(i=$-ZzI*X^nv+|5Q z_xQU{UVn1t;;Mk8)oQ!5YSrg-ZeGn7ouz4)%ejmCM~%Pm?n~ESnty(A>l2H`d(%#Q zK^IHQW}9c4=Y|$b8q#h`@(6kPwA-i07XvkEFD3Z|U;e6}Vud#6*0~+;)?crmf8jf4 z-#fcl8G0Zfjn5oSS_FUAW6E!<2Qh)!iW$Y8i>XCw4yKDK7QiGyZQ_7>06I(sTGrfo zk;jER9ywoj_aWt24k&kW*P3Vb)g$}Sem?r?hKh&O zJq4`KlGOz(g1UBEKdcDVWGIJ9OW ztvW|dq^CQX7=Yc%geWEvQAv~Oq3t$SmffHweEv6l(nuBuhS<4#((w%+UwfM5H9c`4 zf#JCjBI_hSYHQt-L*i4rkw^V?3eF+O7V{Vy7~8b2hn9%RZzF! z;U=t~i+pjMunv7P95YtFu4RL!{RQ<^rGR0Qwd7fZ)iO!fn-nimU!(M2 zreJ~sB2MbBQt&zjv_UwLV)TgU4kK6UuTks`3M`7lsFgZNX;T#BA~)2iO2PN>r~N*H z*I^?TowY#PUDvzjcYLSjy_)Oih$htD=puShn|6uLASV;S44DY7BAKE6yoaLwyp3o- zZzI~zv(SECx=?gVM0xO{W~B`z0BIcLX$)Pudq~kVxGboIS#(=GrrW`dKp9599TA!t z^Kl`ts8#v^nEW#2q}I za%x2>anQ0|~@j%KTboH_e!={MD9v-PItZY6u%)vrFPos?^kw&c1e-50dN_-!CKyw_{oCJ~;R=U*+=682;lbNncNz3qYH7~ivOwXB5I!!RHE zNc%uW13B8)2c-l$1V^xN18Y%hV10svP*hFC;XaUr`h=BeO$@;(fu>=#Skq(!mnE5< zf|)@Qu+6X+bkP~h=lnKKe#z;*=1DP|(sxlPSV6W|q_9Hh27ne>( z<0DtNKuYy=@*!xF;mv?~VAZ`0J1TkgpfKFLlpF;NBM9}Ldzl$sFa~VQjRtX<8A~8f z!?S`7oTdw<$gj*SlcRoydth(If@;Z8xL;83jc#SKzo-l)F5z2CM`t@a3v`t!f#0-P z+!|y~kY#U*B@!2{?r;NDoLojAY{1Fs62M1Mhu~!w%QV&!yBr>c2`DzA4Y0X4r`=f5 zW@cnEVX+yo1{)LeJ0S>U6F>v!OBIq%Vck?Iae;Z6NdN__JD7EHW#O>FYcP~jt36cA{yx0jE?C=TS_EWJ#=gH|Ra_4a1(f`=51$C@Q` z)0rDB+=sbhU}J2<5a2U>A%^}#i(;7C*K~lbR5K}1BA6oR6iMlXIU0zPZw+5azV-<= zNgM(~(&3CQ#;8`}dP$~uQ5i58VDKf&&g_xaWJBGVd)ZlzP{?$1fKy<+Uy+-erKduV zS*48)WbGeg9|BfsSFYbiMsH0Zv}%E@4YxpAu2C&yE?EQl*<~leGYv~t7sNu*w&>+3 zihf%av3bzoaTsIU-`Is_?+iH2HKu)8V``CQ0zLG*3`y^ZG0Ban;I@ALoNV@1-B~s@L=BvbOtHf2P zjTG#qfMguqOFJ^Gs^L-H$@a8LauS?NXqHu?P%1G2YCZ*|EK*6@4Z79eq&Trk>Tgjn zOTioh-Hz4Q{f5&m?M%k#6TZX44TTOR0+*Bbko(8@)3&3R&_Q*Jf+sMM`qZDlQc}BA z5}Z2n6ZW1w0!A-TIC*e6Pz)~6Q?TH!e82fd{~z1`_{M3CGUW zGOcQDgG3Qbxe)`P)xNq$k|O?(ajV4jXUnv?GSI~ro6p2A#uJy}&I{*9 zIjk}#N$PQ}F4n?<){jZk?GVy+FRAE`lIH@XF47$6F6tEAzepZ6LAwZ9O~-WJd-VoB z9|nkPPa*>IcRm|4V=1p@qHWooH}Tp^e#JuN-djg*J@sMH!lth*$JAED(mA8UDgk@C-2UbrLv9LsCZc2b}v4*v~C@@1>cIGU_g zHats4G-yv@a^UXpoCgXUW&~@_!)gNd7qF=YGi5A4F9U4crzVEjDjTfghPei($~|h} z!<>*JplV6x<3bK@krBAX5{C-^V=%d#h(;2s3jcPpg=9EH-mJ-@8tlUVCjd2>6~p7U zSpui0s*C}r4I;yvCqg`u$qAUe?;1`6CE#zfu`D}tVOT%OM~4?ue;bgbzK;O#Pu?!- zf1u!ZD8a$amli0h-$CkHy^mf%%aV0qLj7IjfiI|_eFYJ0fNes4<(<5(i+Nk;U3?p~qZ0K51O~tr__|7v@W% z0Dp2Bva`NgQo5O+YhRN@H`$XS4JLU8Iln8KMs`!Sg!eaLl!xZCJbB&Pp?~B4TC#o0 zbrW+$kJ(F-%dy#Q;a_wJ0;zAYC5e(ZFzY%_IV4r=QDq=}DT@6B?99yR3>!BRsznM! zr)UIjtZci6*JIZP?j1+?lO!6(Y;YNoyM*zSkklC+ijuQjGQsL0h_{+GNJMi4F0Wd1 z?`!O!NvI9oG#E9B%x?yjY40Oqz&ZzZsUM;ZPy?qb_+T=d#C@}0(KzTyHU)}ujK$5K zz*olEj}andBo#wqWKO{h`wfNTq(|Zo1tfqnlP0q9{lyHiUC1(bZFDV>}V9Uqh=o>Te7A)4(^oE%=#A9%`B=|MrkWS1uGT7;0ect$A&0kc8pJt%muvBuzq*0re z?r7ZV8DB#S9hw-}z@ao~hEFp-BpK9c(rhU z?hl)`d86}u2WE-JVXJAwpOxe;=*#Ko2wMfdov5Ey_pzxN&>NtW5w_L~N~#RJ194(E zUb-U!@AWK=^>HL}rM##nvBty(_Oir>5Tr+~*vd(#SZ3mt~Ql9Aqy$Z#MbM9Aq*Hin<$S8;jtWeZo;Z%b9kNWXp9Att>q_ zctb2U9y(-$<08VKrOxH)6w={8GheQ@@O@o9LC46SfWSck0}meqA256dBuI#r4oew2 zO`MzzkCH~m)Hrg-Y?hnYOhbz*M_EQ}P3V017GYRAJ_`H=9}vhcTmuF)gqqYuKS-pc zXp!(RQ3I|op-S0CVn~`0hq2j6aSC5=IB|pJBTDsmfBGk+)MA<2A6-A!4{?NHxVHhP zf)Wz_1vC*p3A4&L2h6ENZ!c#bpV>(>5=rhvlU#$$>I0Dlp(oaUfR6m4G9oP*oX$r= zt>PZNO z%&aL%t3j|%IB&GEo0;(#J);#%hM77RV9HiWVsx4J3C)~-rR(^q4t&}F%;RW@jj!>n zgrkORJxzq1JyKN3OcO*)ttf+r4wSWXtTcGta)i_s*_^i@Odk?K(sIzi-Qq*V9N zIdobnoM}yjVX^4f{Q!uF!cUt=?C7TX5O+YoSO1z>Z!;uP?MsO&h(sJGY{%`H6TrFT z!9h}}u6r`4GUnAGB}C#PcA5t-H&J`S8qM$9GVPHt~ocqL2~zoe+}I+)pUe%xOxjHF$O}yFe9a6 z+rXneOg9!Ve|l0Vaix$cX8Q;s0+j*fa5WrrgJ#aXNF7ROV4Q}b?t`J2SQ%_OhT*_( z!(WjIDyM}8lhT!7vbQvv7y((6Ak&hC7-jGS)j(rMMhp;>oo$JPbU3Vnq>%*(ht@1s zf%S-CQPU)BjEW4kxW@y$n9)^OWH@j1d^jSV>Xgo!f^Bc_YfZSR0>ad2Q%hzFOha&! z(YT=_HcLx&j9dq^YYFuw5{(za;1yW6z|UV<^O;Y3)5cssM`fnntj<7bSq)pabsPk1 zq8>VrK^%d#{rrm@`JG=o0IMR>Mg07gousQEvZ`Vu+$hPB!HRt{>!%=8BqGL)%47SKIMTkuxW*d{5gw#sR8O-UpX~a-m8XYi3 z*v#^&iI`>mHh@3Vw2_l|6`GoieT~!fHI3uPaqx3E4xqrnA%fh1LG?1E?==iS7S(Cy zR(A}R#*1Ss*h9Tt>In2xD9RLH#NINXGFe7^U~{>?Y5Hw+pK;xQaSiUk*eiz6FhHk4 ztsLMO!i-(O4t!{RGKNfsLsA16nwzsnj+vN(Rfvg!O$3JN+6-5^zH8YlY?@kmNBG3( z?v~T1kF<2P=z)``T3b$ed}pG)zQ{|tmpWt=Z}tg zQJ8NpFgiq7IJe_AyiB;#`adCE$5EPLzz%H{cB-D;Ji}NX-2=HUi8UL-xwHR5b^IX( zA5tm%MP(ERDH+1l$jZV7&h-g?QgLJ8J#ti4e}HfQm6)Obi^zoV_lE?J|I;lyr=mCV zVSX$snXR0uoZU9FZQj0AR6Xfh_7_baS}CiTeR<~PJ7u+tWwkf#OJxm{Z7T&u*Dg<8 zzLuIw&9#AnDrj8rG=AzX&Psph@Vm#ZAG=c(TC57)D*1y~KD@H@;p$>C!CVqve$5!b}L?XLOx)%X+@CN zgS@^`N6@DipAJXhTF^#5D=+h#slqq0VoVcj9A%+R3J76JHBdw-8ktlA*C4nUY0_ae zaZ!n%jv6LF4J1axg;nPMBFhxWR*0FM^=cc0U}HjlzHjd6eW-5QZyJ)1|?@tVsSB z`;V)C4&X4o$0@!>tRd&vu`L_n#PT8koOU?bc;G``u?;@t0S@s7!;TMG2Z#SXe$f3* z&{VMxYlBCe*Aj3QkhymRoVKhR7jfy25VPaj88O$%+mtQW!31_ajrcX(5G4!a;%g#~ zptE<@NlRM?yP5>JkLE-DHU<3%bSHo#p3t2~Pq&{w3M=5t^yMN2{~dvGixk(bvQlH4 za?Bjt3;#&db{K`=;9+xl%gKe}Q{j3?jo9S}CgeTIE*Z+uoLZ`|oUP@!CK3IuXTHTY#M0x=<2vv#sK} z-Nzs5$e#@}e@R0pNy9vGKn@jS+j5LN>o~Uq1=e`=r)E;~T}uV^3!ZugKq`sQLH~N+ z?W;)5>A=kviTUp^FYaN=x0M3&K~?|E4F1lXcRB*(!Vw_2LvNoKzvFn%fm1MN-aGT2 zpB%Hd-*S+L^!8Pk+gYA27M**zclI9co&5mc_VDUi&5WEndxpS$t(k7i3E?#imw7~& zWaR2xs%L)V5PVE9IaxU^u*WcrN469C9~ZKGo<-d8Cf+0&9*^w2BxsS0_i?V%I5NL$ zDS_>igH*_FCU^E`)j{4)>zMow0@KcbEtO7D!s4e8qQX3lj^ zDC4`FdlpRTaoqNZURb`)nF)GCi7)Lp(P4Uwb%tAtakG{?WyAbR8! zx<~e!HIU8$vadhf4A3}2)DqN;Q=~{@2u4|$zYGGej&OA}NDMAi8sai2J`y)g_aHG6 zMRvfD1k15$DJ0WjQXPfK7WzPTOjfy~z^z1)vn+L7U&z^I({Y8>0#8M*+dXx^? zn!Pb;8#L=aN#yJ@D?SBnuXAG45U_vOvumc~ox9(y&T{6{9XP!I9qWyp{>+}n!- zqd<*4J?JSP-dbOKHUn6bVW{1+gj|CiWDdAs0%2~2^Qz?_w^8EWpXDM-Cq|i1y9wfS z%cS8JMAwoT;^E7RdT~q{=?Bon5@D!-%*lghB@Fn8UV`?9Yc6n?k2wr}aT#tWF`%)h z=Md39!@bmo%|L#pV~!9eSS9D4F`otFQm}xFSZ-sX*@c*w`1v@}OLI@6MT#-9;=<7| zEvc!0Kq+JnR)3Fzy$Epk0o`1R{iwTQOkoa3Br2r-Px|T|9yJc?vO3qfBhe+YqokrCW*2d}g3G~qf0Kc-*>LBv4bOrdTu0f&%E*V^I^a$yL^Y($}-4kih>tPr#w z&P5_f9RU)1es1-;rLsj0wnx@rxnr5_;Buy{8t86SD9l|c`*$s?F)mPaYsD$&pkquY<}FY2ygv@bq9(g{Ck)nxIf{p zFsM~YuLz`v8xi1q1ziTaagZ5WO=M@>N^3eTcH#yw(@7Gm7^0V(ahoa70c6YNpaG5C%<%EgB_<0jTd(Al51AR1vXA>E+BT)DR8z;^j z5k=%fUZb)jh;NpTG93|(1GJBnX;AF|Yb4asHJPz7th`z0nQ+@G6yTsyYmca`-9gPD zi1lQJWkUl=HJgYcZtb%e8e|KRLHwE10sBLbvu~t}GA;hp2+>V2Jh(K6BxmxuCZ|x) zXgCceM>9Z!c0ebUj2jjVi*e>eMA`~OnQ3`L2TZRWqC6Z(Hqs3)O5(;F>JMFmV~r^2 zRsRNigz4uv+WrVXO|=|>7Vfgay|b)s+zLl-1TqYfR|vk~^^*hf@Cx6hYV25F9Nr{o zfud%k?@s_XV37K+hd@OA-zf4d;r-u01j@Sog0u3TFEG*ix465*{wXkiaVcGlaHqI> zvABA^bE!DU&I#m7PCM-0&7YQ6&h5Psx?O%?^4NV3?!Un?19laG_Kj0GXuzVEe-zlB z-YyiDrg!3s$cYo5KPV!+kGm-8Cfm)+<(s~KjBc;p{Dnq#v5$*JIW4MIlsR} zL<#R8-`f5=8X(P%8ogE!rZMf{B zLrt-t{5A~sqpd9{wgqin`0MBh?&k~j8FFz7?jj$Lct7{i@-pW{+;5?&cI42VYoPswgsHNanDfkr%-b0{!4zo+e2;=& z3VuKV6O)O#Fz)QYO6d+lOAPYX-Poaf4szz`koq}_5HZ#M3BUaZx+`q|UqbLM{ja+#)ZP_#-4&#}!fvGB6?WVeHr*BK@7W!1Jo~k0f9%+K&r>>S zyB3%VOm{AMHczzNbL365ywQHOeKPVZ9TOtXM2q#)txy7p^>eLI0*Lji9-kOYSGvXW z>6Y1}Ge^?`qH~c|dfhK=5^Lvor3Jih?Pafz?5p(aA7t^2C~mzkQ1}nSwsKLrFCa+o z6L#*VOGgSypvYO?w)4JU7R91v+||U{S zp$fym`-eOJs{SwPS1FpV5_Z%qZ`*y}T`X2F`*3eG-uLngt_@BN&Xr6h(oXzFlg5=I z+SI8u<%Gk5%l*dLt7lie^eZG3mEtl%)U#Yvj;pKh=Y_<)Wz^C?)ju6s*wVOA-nf__ zO52fq&zF~W;*Cn7;xe0YQ;KzS2{q%T6rbS7?J5)t;9}i0Rh!PIrn|0oP42i>GgWi- z+-d=(_K8AS<$Y(ZSh}3wp0?wC4+ZEq8ghA8-H6@q5<{YE4hx6Z4F`LDRLx!soiD9Y z>OWi%%f&skW_z$^t>Q89zI~tg*s`%Col{L|_B&Yry~+JCRNN$Sp)uWgXHw&jJH!Yd_jhC*zG}(If+=D!%FkbZk E0mr|ni2wiq literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/click/_compat.py b/.venv/Lib/site-packages/click/_compat.py new file mode 100644 index 0000000..9153d15 --- /dev/null +++ b/.venv/Lib/site-packages/click/_compat.py @@ -0,0 +1,623 @@ +import codecs +import io +import os +import re +import sys +import typing as t +from weakref import WeakKeyDictionary + +CYGWIN = sys.platform.startswith("cygwin") +WIN = sys.platform.startswith("win") +auto_wrap_for_ansi: t.Optional[t.Callable[[t.TextIO], t.TextIO]] = None +_ansi_re = re.compile(r"\033\[[;?0-9]*[a-zA-Z]") + + +def _make_text_stream( + stream: t.BinaryIO, + encoding: t.Optional[str], + errors: t.Optional[str], + force_readable: bool = False, + force_writable: bool = False, +) -> t.TextIO: + if encoding is None: + encoding = get_best_encoding(stream) + if errors is None: + errors = "replace" + return _NonClosingTextIOWrapper( + stream, + encoding, + errors, + line_buffering=True, + force_readable=force_readable, + force_writable=force_writable, + ) + + +def is_ascii_encoding(encoding: str) -> bool: + """Checks if a given encoding is ascii.""" + try: + return codecs.lookup(encoding).name == "ascii" + except LookupError: + return False + + +def get_best_encoding(stream: t.IO[t.Any]) -> str: + """Returns the default stream encoding if not found.""" + rv = getattr(stream, "encoding", None) or sys.getdefaultencoding() + if is_ascii_encoding(rv): + return "utf-8" + return rv + + +class _NonClosingTextIOWrapper(io.TextIOWrapper): + def __init__( + self, + stream: t.BinaryIO, + encoding: t.Optional[str], + errors: t.Optional[str], + force_readable: bool = False, + force_writable: bool = False, + **extra: t.Any, + ) -> None: + self._stream = stream = t.cast( + t.BinaryIO, _FixupStream(stream, force_readable, force_writable) + ) + super().__init__(stream, encoding, errors, **extra) + + def __del__(self) -> None: + try: + self.detach() + except Exception: + pass + + def isatty(self) -> bool: + # https://bitbucket.org/pypy/pypy/issue/1803 + return self._stream.isatty() + + +class _FixupStream: + """The new io interface needs more from streams than streams + traditionally implement. As such, this fix-up code is necessary in + some circumstances. + + The forcing of readable and writable flags are there because some tools + put badly patched objects on sys (one such offender are certain version + of jupyter notebook). + """ + + def __init__( + self, + stream: t.BinaryIO, + force_readable: bool = False, + force_writable: bool = False, + ): + self._stream = stream + self._force_readable = force_readable + self._force_writable = force_writable + + def __getattr__(self, name: str) -> t.Any: + return getattr(self._stream, name) + + def read1(self, size: int) -> bytes: + f = getattr(self._stream, "read1", None) + + if f is not None: + return t.cast(bytes, f(size)) + + return self._stream.read(size) + + def readable(self) -> bool: + if self._force_readable: + return True + x = getattr(self._stream, "readable", None) + if x is not None: + return t.cast(bool, x()) + try: + self._stream.read(0) + except Exception: + return False + return True + + def writable(self) -> bool: + if self._force_writable: + return True + x = getattr(self._stream, "writable", None) + if x is not None: + return t.cast(bool, x()) + try: + self._stream.write("") # type: ignore + except Exception: + try: + self._stream.write(b"") + except Exception: + return False + return True + + def seekable(self) -> bool: + x = getattr(self._stream, "seekable", None) + if x is not None: + return t.cast(bool, x()) + try: + self._stream.seek(self._stream.tell()) + except Exception: + return False + return True + + +def _is_binary_reader(stream: t.IO[t.Any], default: bool = False) -> bool: + try: + return isinstance(stream.read(0), bytes) + except Exception: + return default + # This happens in some cases where the stream was already + # closed. In this case, we assume the default. + + +def _is_binary_writer(stream: t.IO[t.Any], default: bool = False) -> bool: + try: + stream.write(b"") + except Exception: + try: + stream.write("") + return False + except Exception: + pass + return default + return True + + +def _find_binary_reader(stream: t.IO[t.Any]) -> t.Optional[t.BinaryIO]: + # We need to figure out if the given stream is already binary. + # This can happen because the official docs recommend detaching + # the streams to get binary streams. Some code might do this, so + # we need to deal with this case explicitly. + if _is_binary_reader(stream, False): + return t.cast(t.BinaryIO, stream) + + buf = getattr(stream, "buffer", None) + + # Same situation here; this time we assume that the buffer is + # actually binary in case it's closed. + if buf is not None and _is_binary_reader(buf, True): + return t.cast(t.BinaryIO, buf) + + return None + + +def _find_binary_writer(stream: t.IO[t.Any]) -> t.Optional[t.BinaryIO]: + # We need to figure out if the given stream is already binary. + # This can happen because the official docs recommend detaching + # the streams to get binary streams. Some code might do this, so + # we need to deal with this case explicitly. + if _is_binary_writer(stream, False): + return t.cast(t.BinaryIO, stream) + + buf = getattr(stream, "buffer", None) + + # Same situation here; this time we assume that the buffer is + # actually binary in case it's closed. + if buf is not None and _is_binary_writer(buf, True): + return t.cast(t.BinaryIO, buf) + + return None + + +def _stream_is_misconfigured(stream: t.TextIO) -> bool: + """A stream is misconfigured if its encoding is ASCII.""" + # If the stream does not have an encoding set, we assume it's set + # to ASCII. This appears to happen in certain unittest + # environments. It's not quite clear what the correct behavior is + # but this at least will force Click to recover somehow. + return is_ascii_encoding(getattr(stream, "encoding", None) or "ascii") + + +def _is_compat_stream_attr(stream: t.TextIO, attr: str, value: t.Optional[str]) -> bool: + """A stream attribute is compatible if it is equal to the + desired value or the desired value is unset and the attribute + has a value. + """ + stream_value = getattr(stream, attr, None) + return stream_value == value or (value is None and stream_value is not None) + + +def _is_compatible_text_stream( + stream: t.TextIO, encoding: t.Optional[str], errors: t.Optional[str] +) -> bool: + """Check if a stream's encoding and errors attributes are + compatible with the desired values. + """ + return _is_compat_stream_attr( + stream, "encoding", encoding + ) and _is_compat_stream_attr(stream, "errors", errors) + + +def _force_correct_text_stream( + text_stream: t.IO[t.Any], + encoding: t.Optional[str], + errors: t.Optional[str], + is_binary: t.Callable[[t.IO[t.Any], bool], bool], + find_binary: t.Callable[[t.IO[t.Any]], t.Optional[t.BinaryIO]], + force_readable: bool = False, + force_writable: bool = False, +) -> t.TextIO: + if is_binary(text_stream, False): + binary_reader = t.cast(t.BinaryIO, text_stream) + else: + text_stream = t.cast(t.TextIO, text_stream) + # If the stream looks compatible, and won't default to a + # misconfigured ascii encoding, return it as-is. + if _is_compatible_text_stream(text_stream, encoding, errors) and not ( + encoding is None and _stream_is_misconfigured(text_stream) + ): + return text_stream + + # Otherwise, get the underlying binary reader. + possible_binary_reader = find_binary(text_stream) + + # If that's not possible, silently use the original reader + # and get mojibake instead of exceptions. + if possible_binary_reader is None: + return text_stream + + binary_reader = possible_binary_reader + + # Default errors to replace instead of strict in order to get + # something that works. + if errors is None: + errors = "replace" + + # Wrap the binary stream in a text stream with the correct + # encoding parameters. + return _make_text_stream( + binary_reader, + encoding, + errors, + force_readable=force_readable, + force_writable=force_writable, + ) + + +def _force_correct_text_reader( + text_reader: t.IO[t.Any], + encoding: t.Optional[str], + errors: t.Optional[str], + force_readable: bool = False, +) -> t.TextIO: + return _force_correct_text_stream( + text_reader, + encoding, + errors, + _is_binary_reader, + _find_binary_reader, + force_readable=force_readable, + ) + + +def _force_correct_text_writer( + text_writer: t.IO[t.Any], + encoding: t.Optional[str], + errors: t.Optional[str], + force_writable: bool = False, +) -> t.TextIO: + return _force_correct_text_stream( + text_writer, + encoding, + errors, + _is_binary_writer, + _find_binary_writer, + force_writable=force_writable, + ) + + +def get_binary_stdin() -> t.BinaryIO: + reader = _find_binary_reader(sys.stdin) + if reader is None: + raise RuntimeError("Was not able to determine binary stream for sys.stdin.") + return reader + + +def get_binary_stdout() -> t.BinaryIO: + writer = _find_binary_writer(sys.stdout) + if writer is None: + raise RuntimeError("Was not able to determine binary stream for sys.stdout.") + return writer + + +def get_binary_stderr() -> t.BinaryIO: + writer = _find_binary_writer(sys.stderr) + if writer is None: + raise RuntimeError("Was not able to determine binary stream for sys.stderr.") + return writer + + +def get_text_stdin( + encoding: t.Optional[str] = None, errors: t.Optional[str] = None +) -> t.TextIO: + rv = _get_windows_console_stream(sys.stdin, encoding, errors) + if rv is not None: + return rv + return _force_correct_text_reader(sys.stdin, encoding, errors, force_readable=True) + + +def get_text_stdout( + encoding: t.Optional[str] = None, errors: t.Optional[str] = None +) -> t.TextIO: + rv = _get_windows_console_stream(sys.stdout, encoding, errors) + if rv is not None: + return rv + return _force_correct_text_writer(sys.stdout, encoding, errors, force_writable=True) + + +def get_text_stderr( + encoding: t.Optional[str] = None, errors: t.Optional[str] = None +) -> t.TextIO: + rv = _get_windows_console_stream(sys.stderr, encoding, errors) + if rv is not None: + return rv + return _force_correct_text_writer(sys.stderr, encoding, errors, force_writable=True) + + +def _wrap_io_open( + file: t.Union[str, "os.PathLike[str]", int], + mode: str, + encoding: t.Optional[str], + errors: t.Optional[str], +) -> t.IO[t.Any]: + """Handles not passing ``encoding`` and ``errors`` in binary mode.""" + if "b" in mode: + return open(file, mode) + + return open(file, mode, encoding=encoding, errors=errors) + + +def open_stream( + filename: "t.Union[str, os.PathLike[str]]", + mode: str = "r", + encoding: t.Optional[str] = None, + errors: t.Optional[str] = "strict", + atomic: bool = False, +) -> t.Tuple[t.IO[t.Any], bool]: + binary = "b" in mode + filename = os.fspath(filename) + + # Standard streams first. These are simple because they ignore the + # atomic flag. Use fsdecode to handle Path("-"). + if os.fsdecode(filename) == "-": + if any(m in mode for m in ["w", "a", "x"]): + if binary: + return get_binary_stdout(), False + return get_text_stdout(encoding=encoding, errors=errors), False + if binary: + return get_binary_stdin(), False + return get_text_stdin(encoding=encoding, errors=errors), False + + # Non-atomic writes directly go out through the regular open functions. + if not atomic: + return _wrap_io_open(filename, mode, encoding, errors), True + + # Some usability stuff for atomic writes + if "a" in mode: + raise ValueError( + "Appending to an existing file is not supported, because that" + " would involve an expensive `copy`-operation to a temporary" + " file. Open the file in normal `w`-mode and copy explicitly" + " if that's what you're after." + ) + if "x" in mode: + raise ValueError("Use the `overwrite`-parameter instead.") + if "w" not in mode: + raise ValueError("Atomic writes only make sense with `w`-mode.") + + # Atomic writes are more complicated. They work by opening a file + # as a proxy in the same folder and then using the fdopen + # functionality to wrap it in a Python file. Then we wrap it in an + # atomic file that moves the file over on close. + import errno + import random + + try: + perm: t.Optional[int] = os.stat(filename).st_mode + except OSError: + perm = None + + flags = os.O_RDWR | os.O_CREAT | os.O_EXCL + + if binary: + flags |= getattr(os, "O_BINARY", 0) + + while True: + tmp_filename = os.path.join( + os.path.dirname(filename), + f".__atomic-write{random.randrange(1 << 32):08x}", + ) + try: + fd = os.open(tmp_filename, flags, 0o666 if perm is None else perm) + break + except OSError as e: + if e.errno == errno.EEXIST or ( + os.name == "nt" + and e.errno == errno.EACCES + and os.path.isdir(e.filename) + and os.access(e.filename, os.W_OK) + ): + continue + raise + + if perm is not None: + os.chmod(tmp_filename, perm) # in case perm includes bits in umask + + f = _wrap_io_open(fd, mode, encoding, errors) + af = _AtomicFile(f, tmp_filename, os.path.realpath(filename)) + return t.cast(t.IO[t.Any], af), True + + +class _AtomicFile: + def __init__(self, f: t.IO[t.Any], tmp_filename: str, real_filename: str) -> None: + self._f = f + self._tmp_filename = tmp_filename + self._real_filename = real_filename + self.closed = False + + @property + def name(self) -> str: + return self._real_filename + + def close(self, delete: bool = False) -> None: + if self.closed: + return + self._f.close() + os.replace(self._tmp_filename, self._real_filename) + self.closed = True + + def __getattr__(self, name: str) -> t.Any: + return getattr(self._f, name) + + def __enter__(self) -> "_AtomicFile": + return self + + def __exit__(self, exc_type: t.Optional[t.Type[BaseException]], *_: t.Any) -> None: + self.close(delete=exc_type is not None) + + def __repr__(self) -> str: + return repr(self._f) + + +def strip_ansi(value: str) -> str: + return _ansi_re.sub("", value) + + +def _is_jupyter_kernel_output(stream: t.IO[t.Any]) -> bool: + while isinstance(stream, (_FixupStream, _NonClosingTextIOWrapper)): + stream = stream._stream + + return stream.__class__.__module__.startswith("ipykernel.") + + +def should_strip_ansi( + stream: t.Optional[t.IO[t.Any]] = None, color: t.Optional[bool] = None +) -> bool: + if color is None: + if stream is None: + stream = sys.stdin + return not isatty(stream) and not _is_jupyter_kernel_output(stream) + return not color + + +# On Windows, wrap the output streams with colorama to support ANSI +# color codes. +# NOTE: double check is needed so mypy does not analyze this on Linux +if sys.platform.startswith("win") and WIN: + from ._winconsole import _get_windows_console_stream + + def _get_argv_encoding() -> str: + import locale + + return locale.getpreferredencoding() + + _ansi_stream_wrappers: t.MutableMapping[t.TextIO, t.TextIO] = WeakKeyDictionary() + + def auto_wrap_for_ansi( + stream: t.TextIO, color: t.Optional[bool] = None + ) -> t.TextIO: + """Support ANSI color and style codes on Windows by wrapping a + stream with colorama. + """ + try: + cached = _ansi_stream_wrappers.get(stream) + except Exception: + cached = None + + if cached is not None: + return cached + + import colorama + + strip = should_strip_ansi(stream, color) + ansi_wrapper = colorama.AnsiToWin32(stream, strip=strip) + rv = t.cast(t.TextIO, ansi_wrapper.stream) + _write = rv.write + + def _safe_write(s): + try: + return _write(s) + except BaseException: + ansi_wrapper.reset_all() + raise + + rv.write = _safe_write + + try: + _ansi_stream_wrappers[stream] = rv + except Exception: + pass + + return rv + +else: + + def _get_argv_encoding() -> str: + return getattr(sys.stdin, "encoding", None) or sys.getfilesystemencoding() + + def _get_windows_console_stream( + f: t.TextIO, encoding: t.Optional[str], errors: t.Optional[str] + ) -> t.Optional[t.TextIO]: + return None + + +def term_len(x: str) -> int: + return len(strip_ansi(x)) + + +def isatty(stream: t.IO[t.Any]) -> bool: + try: + return stream.isatty() + except Exception: + return False + + +def _make_cached_stream_func( + src_func: t.Callable[[], t.Optional[t.TextIO]], + wrapper_func: t.Callable[[], t.TextIO], +) -> t.Callable[[], t.Optional[t.TextIO]]: + cache: t.MutableMapping[t.TextIO, t.TextIO] = WeakKeyDictionary() + + def func() -> t.Optional[t.TextIO]: + stream = src_func() + + if stream is None: + return None + + try: + rv = cache.get(stream) + except Exception: + rv = None + if rv is not None: + return rv + rv = wrapper_func() + try: + cache[stream] = rv + except Exception: + pass + return rv + + return func + + +_default_text_stdin = _make_cached_stream_func(lambda: sys.stdin, get_text_stdin) +_default_text_stdout = _make_cached_stream_func(lambda: sys.stdout, get_text_stdout) +_default_text_stderr = _make_cached_stream_func(lambda: sys.stderr, get_text_stderr) + + +binary_streams: t.Mapping[str, t.Callable[[], t.BinaryIO]] = { + "stdin": get_binary_stdin, + "stdout": get_binary_stdout, + "stderr": get_binary_stderr, +} + +text_streams: t.Mapping[ + str, t.Callable[[t.Optional[str], t.Optional[str]], t.TextIO] +] = { + "stdin": get_text_stdin, + "stdout": get_text_stdout, + "stderr": get_text_stderr, +} diff --git a/.venv/Lib/site-packages/click/_termui_impl.py b/.venv/Lib/site-packages/click/_termui_impl.py new file mode 100644 index 0000000..ad9f8f6 --- /dev/null +++ b/.venv/Lib/site-packages/click/_termui_impl.py @@ -0,0 +1,788 @@ +""" +This module contains implementations for the termui module. To keep the +import time of Click down, some infrequently used functionality is +placed in this module and only imported as needed. +""" + +import contextlib +import math +import os +import sys +import time +import typing as t +from gettext import gettext as _ +from io import StringIO +from shutil import which +from types import TracebackType + +from ._compat import _default_text_stdout +from ._compat import CYGWIN +from ._compat import get_best_encoding +from ._compat import isatty +from ._compat import open_stream +from ._compat import strip_ansi +from ._compat import term_len +from ._compat import WIN +from .exceptions import ClickException +from .utils import echo + +V = t.TypeVar("V") + +if os.name == "nt": + BEFORE_BAR = "\r" + AFTER_BAR = "\n" +else: + BEFORE_BAR = "\r\033[?25l" + AFTER_BAR = "\033[?25h\n" + + +class ProgressBar(t.Generic[V]): + def __init__( + self, + iterable: t.Optional[t.Iterable[V]], + length: t.Optional[int] = None, + fill_char: str = "#", + empty_char: str = " ", + bar_template: str = "%(bar)s", + info_sep: str = " ", + show_eta: bool = True, + show_percent: t.Optional[bool] = None, + show_pos: bool = False, + item_show_func: t.Optional[t.Callable[[t.Optional[V]], t.Optional[str]]] = None, + label: t.Optional[str] = None, + file: t.Optional[t.TextIO] = None, + color: t.Optional[bool] = None, + update_min_steps: int = 1, + width: int = 30, + ) -> None: + self.fill_char = fill_char + self.empty_char = empty_char + self.bar_template = bar_template + self.info_sep = info_sep + self.show_eta = show_eta + self.show_percent = show_percent + self.show_pos = show_pos + self.item_show_func = item_show_func + self.label: str = label or "" + + if file is None: + file = _default_text_stdout() + + # There are no standard streams attached to write to. For example, + # pythonw on Windows. + if file is None: + file = StringIO() + + self.file = file + self.color = color + self.update_min_steps = update_min_steps + self._completed_intervals = 0 + self.width: int = width + self.autowidth: bool = width == 0 + + if length is None: + from operator import length_hint + + length = length_hint(iterable, -1) + + if length == -1: + length = None + if iterable is None: + if length is None: + raise TypeError("iterable or length is required") + iterable = t.cast(t.Iterable[V], range(length)) + self.iter: t.Iterable[V] = iter(iterable) + self.length = length + self.pos = 0 + self.avg: t.List[float] = [] + self.last_eta: float + self.start: float + self.start = self.last_eta = time.time() + self.eta_known: bool = False + self.finished: bool = False + self.max_width: t.Optional[int] = None + self.entered: bool = False + self.current_item: t.Optional[V] = None + self.is_hidden: bool = not isatty(self.file) + self._last_line: t.Optional[str] = None + + def __enter__(self) -> "ProgressBar[V]": + self.entered = True + self.render_progress() + return self + + def __exit__( + self, + exc_type: t.Optional[t.Type[BaseException]], + exc_value: t.Optional[BaseException], + tb: t.Optional[TracebackType], + ) -> None: + self.render_finish() + + def __iter__(self) -> t.Iterator[V]: + if not self.entered: + raise RuntimeError("You need to use progress bars in a with block.") + self.render_progress() + return self.generator() + + def __next__(self) -> V: + # Iteration is defined in terms of a generator function, + # returned by iter(self); use that to define next(). This works + # because `self.iter` is an iterable consumed by that generator, + # so it is re-entry safe. Calling `next(self.generator())` + # twice works and does "what you want". + return next(iter(self)) + + def render_finish(self) -> None: + if self.is_hidden: + return + self.file.write(AFTER_BAR) + self.file.flush() + + @property + def pct(self) -> float: + if self.finished: + return 1.0 + return min(self.pos / (float(self.length or 1) or 1), 1.0) + + @property + def time_per_iteration(self) -> float: + if not self.avg: + return 0.0 + return sum(self.avg) / float(len(self.avg)) + + @property + def eta(self) -> float: + if self.length is not None and not self.finished: + return self.time_per_iteration * (self.length - self.pos) + return 0.0 + + def format_eta(self) -> str: + if self.eta_known: + t = int(self.eta) + seconds = t % 60 + t //= 60 + minutes = t % 60 + t //= 60 + hours = t % 24 + t //= 24 + if t > 0: + return f"{t}d {hours:02}:{minutes:02}:{seconds:02}" + else: + return f"{hours:02}:{minutes:02}:{seconds:02}" + return "" + + def format_pos(self) -> str: + pos = str(self.pos) + if self.length is not None: + pos += f"/{self.length}" + return pos + + def format_pct(self) -> str: + return f"{int(self.pct * 100): 4}%"[1:] + + def format_bar(self) -> str: + if self.length is not None: + bar_length = int(self.pct * self.width) + bar = self.fill_char * bar_length + bar += self.empty_char * (self.width - bar_length) + elif self.finished: + bar = self.fill_char * self.width + else: + chars = list(self.empty_char * (self.width or 1)) + if self.time_per_iteration != 0: + chars[ + int( + (math.cos(self.pos * self.time_per_iteration) / 2.0 + 0.5) + * self.width + ) + ] = self.fill_char + bar = "".join(chars) + return bar + + def format_progress_line(self) -> str: + show_percent = self.show_percent + + info_bits = [] + if self.length is not None and show_percent is None: + show_percent = not self.show_pos + + if self.show_pos: + info_bits.append(self.format_pos()) + if show_percent: + info_bits.append(self.format_pct()) + if self.show_eta and self.eta_known and not self.finished: + info_bits.append(self.format_eta()) + if self.item_show_func is not None: + item_info = self.item_show_func(self.current_item) + if item_info is not None: + info_bits.append(item_info) + + return ( + self.bar_template + % { + "label": self.label, + "bar": self.format_bar(), + "info": self.info_sep.join(info_bits), + } + ).rstrip() + + def render_progress(self) -> None: + import shutil + + if self.is_hidden: + # Only output the label as it changes if the output is not a + # TTY. Use file=stderr if you expect to be piping stdout. + if self._last_line != self.label: + self._last_line = self.label + echo(self.label, file=self.file, color=self.color) + + return + + buf = [] + # Update width in case the terminal has been resized + if self.autowidth: + old_width = self.width + self.width = 0 + clutter_length = term_len(self.format_progress_line()) + new_width = max(0, shutil.get_terminal_size().columns - clutter_length) + if new_width < old_width: + buf.append(BEFORE_BAR) + buf.append(" " * self.max_width) # type: ignore + self.max_width = new_width + self.width = new_width + + clear_width = self.width + if self.max_width is not None: + clear_width = self.max_width + + buf.append(BEFORE_BAR) + line = self.format_progress_line() + line_len = term_len(line) + if self.max_width is None or self.max_width < line_len: + self.max_width = line_len + + buf.append(line) + buf.append(" " * (clear_width - line_len)) + line = "".join(buf) + # Render the line only if it changed. + + if line != self._last_line: + self._last_line = line + echo(line, file=self.file, color=self.color, nl=False) + self.file.flush() + + def make_step(self, n_steps: int) -> None: + self.pos += n_steps + if self.length is not None and self.pos >= self.length: + self.finished = True + + if (time.time() - self.last_eta) < 1.0: + return + + self.last_eta = time.time() + + # self.avg is a rolling list of length <= 7 of steps where steps are + # defined as time elapsed divided by the total progress through + # self.length. + if self.pos: + step = (time.time() - self.start) / self.pos + else: + step = time.time() - self.start + + self.avg = self.avg[-6:] + [step] + + self.eta_known = self.length is not None + + def update(self, n_steps: int, current_item: t.Optional[V] = None) -> None: + """Update the progress bar by advancing a specified number of + steps, and optionally set the ``current_item`` for this new + position. + + :param n_steps: Number of steps to advance. + :param current_item: Optional item to set as ``current_item`` + for the updated position. + + .. versionchanged:: 8.0 + Added the ``current_item`` optional parameter. + + .. versionchanged:: 8.0 + Only render when the number of steps meets the + ``update_min_steps`` threshold. + """ + if current_item is not None: + self.current_item = current_item + + self._completed_intervals += n_steps + + if self._completed_intervals >= self.update_min_steps: + self.make_step(self._completed_intervals) + self.render_progress() + self._completed_intervals = 0 + + def finish(self) -> None: + self.eta_known = False + self.current_item = None + self.finished = True + + def generator(self) -> t.Iterator[V]: + """Return a generator which yields the items added to the bar + during construction, and updates the progress bar *after* the + yielded block returns. + """ + # WARNING: the iterator interface for `ProgressBar` relies on + # this and only works because this is a simple generator which + # doesn't create or manage additional state. If this function + # changes, the impact should be evaluated both against + # `iter(bar)` and `next(bar)`. `next()` in particular may call + # `self.generator()` repeatedly, and this must remain safe in + # order for that interface to work. + if not self.entered: + raise RuntimeError("You need to use progress bars in a with block.") + + if self.is_hidden: + yield from self.iter + else: + for rv in self.iter: + self.current_item = rv + + # This allows show_item_func to be updated before the + # item is processed. Only trigger at the beginning of + # the update interval. + if self._completed_intervals == 0: + self.render_progress() + + yield rv + self.update(1) + + self.finish() + self.render_progress() + + +def pager(generator: t.Iterable[str], color: t.Optional[bool] = None) -> None: + """Decide what method to use for paging through text.""" + stdout = _default_text_stdout() + + # There are no standard streams attached to write to. For example, + # pythonw on Windows. + if stdout is None: + stdout = StringIO() + + if not isatty(sys.stdin) or not isatty(stdout): + return _nullpager(stdout, generator, color) + pager_cmd = (os.environ.get("PAGER", None) or "").strip() + if pager_cmd: + if WIN: + if _tempfilepager(generator, pager_cmd, color): + return + elif _pipepager(generator, pager_cmd, color): + return + if os.environ.get("TERM") in ("dumb", "emacs"): + return _nullpager(stdout, generator, color) + if (WIN or sys.platform.startswith("os2")) and _tempfilepager( + generator, "more", color + ): + return + if _pipepager(generator, "less", color): + return + + import tempfile + + fd, filename = tempfile.mkstemp() + os.close(fd) + try: + if _pipepager(generator, "more", color): + return + return _nullpager(stdout, generator, color) + finally: + os.unlink(filename) + + +def _pipepager(generator: t.Iterable[str], cmd: str, color: t.Optional[bool]) -> bool: + """Page through text by feeding it to another program. Invoking a + pager through this might support colors. + + Returns True if the command was found, False otherwise and thus another + pager should be attempted. + """ + cmd_absolute = which(cmd) + if cmd_absolute is None: + return False + + import subprocess + + env = dict(os.environ) + + # If we're piping to less we might support colors under the + # condition that + cmd_detail = cmd.rsplit("/", 1)[-1].split() + if color is None and cmd_detail[0] == "less": + less_flags = f"{os.environ.get('LESS', '')}{' '.join(cmd_detail[1:])}" + if not less_flags: + env["LESS"] = "-R" + color = True + elif "r" in less_flags or "R" in less_flags: + color = True + + c = subprocess.Popen( + [cmd_absolute], + shell=True, + stdin=subprocess.PIPE, + env=env, + errors="replace", + text=True, + ) + assert c.stdin is not None + try: + for text in generator: + if not color: + text = strip_ansi(text) + + c.stdin.write(text) + except (OSError, KeyboardInterrupt): + pass + else: + c.stdin.close() + + # Less doesn't respect ^C, but catches it for its own UI purposes (aborting + # search or other commands inside less). + # + # That means when the user hits ^C, the parent process (click) terminates, + # but less is still alive, paging the output and messing up the terminal. + # + # If the user wants to make the pager exit on ^C, they should set + # `LESS='-K'`. It's not our decision to make. + while True: + try: + c.wait() + except KeyboardInterrupt: + pass + else: + break + + return True + + +def _tempfilepager( + generator: t.Iterable[str], + cmd: str, + color: t.Optional[bool], +) -> bool: + """Page through text by invoking a program on a temporary file. + + Returns True if the command was found, False otherwise and thus another + pager should be attempted. + """ + # Which is necessary for Windows, it is also recommended in the Popen docs. + cmd_absolute = which(cmd) + if cmd_absolute is None: + return False + + import subprocess + import tempfile + + fd, filename = tempfile.mkstemp() + # TODO: This never terminates if the passed generator never terminates. + text = "".join(generator) + if not color: + text = strip_ansi(text) + encoding = get_best_encoding(sys.stdout) + with open_stream(filename, "wb")[0] as f: + f.write(text.encode(encoding)) + try: + subprocess.call([cmd_absolute, filename]) + except OSError: + # Command not found + pass + finally: + os.close(fd) + os.unlink(filename) + + return True + + +def _nullpager( + stream: t.TextIO, generator: t.Iterable[str], color: t.Optional[bool] +) -> None: + """Simply print unformatted text. This is the ultimate fallback.""" + for text in generator: + if not color: + text = strip_ansi(text) + stream.write(text) + + +class Editor: + def __init__( + self, + editor: t.Optional[str] = None, + env: t.Optional[t.Mapping[str, str]] = None, + require_save: bool = True, + extension: str = ".txt", + ) -> None: + self.editor = editor + self.env = env + self.require_save = require_save + self.extension = extension + + def get_editor(self) -> str: + if self.editor is not None: + return self.editor + for key in "VISUAL", "EDITOR": + rv = os.environ.get(key) + if rv: + return rv + if WIN: + return "notepad" + for editor in "sensible-editor", "vim", "nano": + if which(editor) is not None: + return editor + return "vi" + + def edit_file(self, filename: str) -> None: + import subprocess + + editor = self.get_editor() + environ: t.Optional[t.Dict[str, str]] = None + + if self.env: + environ = os.environ.copy() + environ.update(self.env) + + try: + c = subprocess.Popen(f'{editor} "{filename}"', env=environ, shell=True) + exit_code = c.wait() + if exit_code != 0: + raise ClickException( + _("{editor}: Editing failed").format(editor=editor) + ) + except OSError as e: + raise ClickException( + _("{editor}: Editing failed: {e}").format(editor=editor, e=e) + ) from e + + def edit(self, text: t.Optional[t.AnyStr]) -> t.Optional[t.AnyStr]: + import tempfile + + if not text: + data = b"" + elif isinstance(text, (bytes, bytearray)): + data = text + else: + if text and not text.endswith("\n"): + text += "\n" + + if WIN: + data = text.replace("\n", "\r\n").encode("utf-8-sig") + else: + data = text.encode("utf-8") + + fd, name = tempfile.mkstemp(prefix="editor-", suffix=self.extension) + f: t.BinaryIO + + try: + with os.fdopen(fd, "wb") as f: + f.write(data) + + # If the filesystem resolution is 1 second, like Mac OS + # 10.12 Extended, or 2 seconds, like FAT32, and the editor + # closes very fast, require_save can fail. Set the modified + # time to be 2 seconds in the past to work around this. + os.utime(name, (os.path.getatime(name), os.path.getmtime(name) - 2)) + # Depending on the resolution, the exact value might not be + # recorded, so get the new recorded value. + timestamp = os.path.getmtime(name) + + self.edit_file(name) + + if self.require_save and os.path.getmtime(name) == timestamp: + return None + + with open(name, "rb") as f: + rv = f.read() + + if isinstance(text, (bytes, bytearray)): + return rv + + return rv.decode("utf-8-sig").replace("\r\n", "\n") # type: ignore + finally: + os.unlink(name) + + +def open_url(url: str, wait: bool = False, locate: bool = False) -> int: + import subprocess + + def _unquote_file(url: str) -> str: + from urllib.parse import unquote + + if url.startswith("file://"): + url = unquote(url[7:]) + + return url + + if sys.platform == "darwin": + args = ["open"] + if wait: + args.append("-W") + if locate: + args.append("-R") + args.append(_unquote_file(url)) + null = open("/dev/null", "w") + try: + return subprocess.Popen(args, stderr=null).wait() + finally: + null.close() + elif WIN: + if locate: + url = _unquote_file(url) + args = ["explorer", f"/select,{url}"] + else: + args = ["start"] + if wait: + args.append("/WAIT") + args.append("") + args.append(url) + try: + return subprocess.call(args) + except OSError: + # Command not found + return 127 + elif CYGWIN: + if locate: + url = _unquote_file(url) + args = ["cygstart", os.path.dirname(url)] + else: + args = ["cygstart"] + if wait: + args.append("-w") + args.append(url) + try: + return subprocess.call(args) + except OSError: + # Command not found + return 127 + + try: + if locate: + url = os.path.dirname(_unquote_file(url)) or "." + else: + url = _unquote_file(url) + c = subprocess.Popen(["xdg-open", url]) + if wait: + return c.wait() + return 0 + except OSError: + if url.startswith(("http://", "https://")) and not locate and not wait: + import webbrowser + + webbrowser.open(url) + return 0 + return 1 + + +def _translate_ch_to_exc(ch: str) -> t.Optional[BaseException]: + if ch == "\x03": + raise KeyboardInterrupt() + + if ch == "\x04" and not WIN: # Unix-like, Ctrl+D + raise EOFError() + + if ch == "\x1a" and WIN: # Windows, Ctrl+Z + raise EOFError() + + return None + + +if WIN: + import msvcrt + + @contextlib.contextmanager + def raw_terminal() -> t.Iterator[int]: + yield -1 + + def getchar(echo: bool) -> str: + # The function `getch` will return a bytes object corresponding to + # the pressed character. Since Windows 10 build 1803, it will also + # return \x00 when called a second time after pressing a regular key. + # + # `getwch` does not share this probably-bugged behavior. Moreover, it + # returns a Unicode object by default, which is what we want. + # + # Either of these functions will return \x00 or \xe0 to indicate + # a special key, and you need to call the same function again to get + # the "rest" of the code. The fun part is that \u00e0 is + # "latin small letter a with grave", so if you type that on a French + # keyboard, you _also_ get a \xe0. + # E.g., consider the Up arrow. This returns \xe0 and then \x48. The + # resulting Unicode string reads as "a with grave" + "capital H". + # This is indistinguishable from when the user actually types + # "a with grave" and then "capital H". + # + # When \xe0 is returned, we assume it's part of a special-key sequence + # and call `getwch` again, but that means that when the user types + # the \u00e0 character, `getchar` doesn't return until a second + # character is typed. + # The alternative is returning immediately, but that would mess up + # cross-platform handling of arrow keys and others that start with + # \xe0. Another option is using `getch`, but then we can't reliably + # read non-ASCII characters, because return values of `getch` are + # limited to the current 8-bit codepage. + # + # Anyway, Click doesn't claim to do this Right(tm), and using `getwch` + # is doing the right thing in more situations than with `getch`. + func: t.Callable[[], str] + + if echo: + func = msvcrt.getwche # type: ignore + else: + func = msvcrt.getwch # type: ignore + + rv = func() + + if rv in ("\x00", "\xe0"): + # \x00 and \xe0 are control characters that indicate special key, + # see above. + rv += func() + + _translate_ch_to_exc(rv) + return rv + +else: + import termios + import tty + + @contextlib.contextmanager + def raw_terminal() -> t.Iterator[int]: + f: t.Optional[t.TextIO] + fd: int + + if not isatty(sys.stdin): + f = open("/dev/tty") + fd = f.fileno() + else: + fd = sys.stdin.fileno() + f = None + + try: + old_settings = termios.tcgetattr(fd) + + try: + tty.setraw(fd) + yield fd + finally: + termios.tcsetattr(fd, termios.TCSADRAIN, old_settings) + sys.stdout.flush() + + if f is not None: + f.close() + except termios.error: + pass + + def getchar(echo: bool) -> str: + with raw_terminal() as fd: + ch = os.read(fd, 32).decode(get_best_encoding(sys.stdin), "replace") + + if echo and isatty(sys.stdout): + sys.stdout.write(ch) + + _translate_ch_to_exc(ch) + return ch diff --git a/.venv/Lib/site-packages/click/_textwrap.py b/.venv/Lib/site-packages/click/_textwrap.py new file mode 100644 index 0000000..b47dcbd --- /dev/null +++ b/.venv/Lib/site-packages/click/_textwrap.py @@ -0,0 +1,49 @@ +import textwrap +import typing as t +from contextlib import contextmanager + + +class TextWrapper(textwrap.TextWrapper): + def _handle_long_word( + self, + reversed_chunks: t.List[str], + cur_line: t.List[str], + cur_len: int, + width: int, + ) -> None: + space_left = max(width - cur_len, 1) + + if self.break_long_words: + last = reversed_chunks[-1] + cut = last[:space_left] + res = last[space_left:] + cur_line.append(cut) + reversed_chunks[-1] = res + elif not cur_line: + cur_line.append(reversed_chunks.pop()) + + @contextmanager + def extra_indent(self, indent: str) -> t.Iterator[None]: + old_initial_indent = self.initial_indent + old_subsequent_indent = self.subsequent_indent + self.initial_indent += indent + self.subsequent_indent += indent + + try: + yield + finally: + self.initial_indent = old_initial_indent + self.subsequent_indent = old_subsequent_indent + + def indent_only(self, text: str) -> str: + rv = [] + + for idx, line in enumerate(text.splitlines()): + indent = self.initial_indent + + if idx > 0: + indent = self.subsequent_indent + + rv.append(f"{indent}{line}") + + return "\n".join(rv) diff --git a/.venv/Lib/site-packages/click/_winconsole.py b/.venv/Lib/site-packages/click/_winconsole.py new file mode 100644 index 0000000..6b20df3 --- /dev/null +++ b/.venv/Lib/site-packages/click/_winconsole.py @@ -0,0 +1,279 @@ +# This module is based on the excellent work by Adam Bartoš who +# provided a lot of what went into the implementation here in +# the discussion to issue1602 in the Python bug tracker. +# +# There are some general differences in regards to how this works +# compared to the original patches as we do not need to patch +# the entire interpreter but just work in our little world of +# echo and prompt. +import io +import sys +import time +import typing as t +from ctypes import byref +from ctypes import c_char +from ctypes import c_char_p +from ctypes import c_int +from ctypes import c_ssize_t +from ctypes import c_ulong +from ctypes import c_void_p +from ctypes import POINTER +from ctypes import py_object +from ctypes import Structure +from ctypes.wintypes import DWORD +from ctypes.wintypes import HANDLE +from ctypes.wintypes import LPCWSTR +from ctypes.wintypes import LPWSTR + +from ._compat import _NonClosingTextIOWrapper + +assert sys.platform == "win32" +import msvcrt # noqa: E402 +from ctypes import windll # noqa: E402 +from ctypes import WINFUNCTYPE # noqa: E402 + +c_ssize_p = POINTER(c_ssize_t) + +kernel32 = windll.kernel32 +GetStdHandle = kernel32.GetStdHandle +ReadConsoleW = kernel32.ReadConsoleW +WriteConsoleW = kernel32.WriteConsoleW +GetConsoleMode = kernel32.GetConsoleMode +GetLastError = kernel32.GetLastError +GetCommandLineW = WINFUNCTYPE(LPWSTR)(("GetCommandLineW", windll.kernel32)) +CommandLineToArgvW = WINFUNCTYPE(POINTER(LPWSTR), LPCWSTR, POINTER(c_int))( + ("CommandLineToArgvW", windll.shell32) +) +LocalFree = WINFUNCTYPE(c_void_p, c_void_p)(("LocalFree", windll.kernel32)) + +STDIN_HANDLE = GetStdHandle(-10) +STDOUT_HANDLE = GetStdHandle(-11) +STDERR_HANDLE = GetStdHandle(-12) + +PyBUF_SIMPLE = 0 +PyBUF_WRITABLE = 1 + +ERROR_SUCCESS = 0 +ERROR_NOT_ENOUGH_MEMORY = 8 +ERROR_OPERATION_ABORTED = 995 + +STDIN_FILENO = 0 +STDOUT_FILENO = 1 +STDERR_FILENO = 2 + +EOF = b"\x1a" +MAX_BYTES_WRITTEN = 32767 + +try: + from ctypes import pythonapi +except ImportError: + # On PyPy we cannot get buffers so our ability to operate here is + # severely limited. + get_buffer = None +else: + + class Py_buffer(Structure): + _fields_ = [ + ("buf", c_void_p), + ("obj", py_object), + ("len", c_ssize_t), + ("itemsize", c_ssize_t), + ("readonly", c_int), + ("ndim", c_int), + ("format", c_char_p), + ("shape", c_ssize_p), + ("strides", c_ssize_p), + ("suboffsets", c_ssize_p), + ("internal", c_void_p), + ] + + PyObject_GetBuffer = pythonapi.PyObject_GetBuffer + PyBuffer_Release = pythonapi.PyBuffer_Release + + def get_buffer(obj, writable=False): + buf = Py_buffer() + flags = PyBUF_WRITABLE if writable else PyBUF_SIMPLE + PyObject_GetBuffer(py_object(obj), byref(buf), flags) + + try: + buffer_type = c_char * buf.len + return buffer_type.from_address(buf.buf) + finally: + PyBuffer_Release(byref(buf)) + + +class _WindowsConsoleRawIOBase(io.RawIOBase): + def __init__(self, handle): + self.handle = handle + + def isatty(self): + super().isatty() + return True + + +class _WindowsConsoleReader(_WindowsConsoleRawIOBase): + def readable(self): + return True + + def readinto(self, b): + bytes_to_be_read = len(b) + if not bytes_to_be_read: + return 0 + elif bytes_to_be_read % 2: + raise ValueError( + "cannot read odd number of bytes from UTF-16-LE encoded console" + ) + + buffer = get_buffer(b, writable=True) + code_units_to_be_read = bytes_to_be_read // 2 + code_units_read = c_ulong() + + rv = ReadConsoleW( + HANDLE(self.handle), + buffer, + code_units_to_be_read, + byref(code_units_read), + None, + ) + if GetLastError() == ERROR_OPERATION_ABORTED: + # wait for KeyboardInterrupt + time.sleep(0.1) + if not rv: + raise OSError(f"Windows error: {GetLastError()}") + + if buffer[0] == EOF: + return 0 + return 2 * code_units_read.value + + +class _WindowsConsoleWriter(_WindowsConsoleRawIOBase): + def writable(self): + return True + + @staticmethod + def _get_error_message(errno): + if errno == ERROR_SUCCESS: + return "ERROR_SUCCESS" + elif errno == ERROR_NOT_ENOUGH_MEMORY: + return "ERROR_NOT_ENOUGH_MEMORY" + return f"Windows error {errno}" + + def write(self, b): + bytes_to_be_written = len(b) + buf = get_buffer(b) + code_units_to_be_written = min(bytes_to_be_written, MAX_BYTES_WRITTEN) // 2 + code_units_written = c_ulong() + + WriteConsoleW( + HANDLE(self.handle), + buf, + code_units_to_be_written, + byref(code_units_written), + None, + ) + bytes_written = 2 * code_units_written.value + + if bytes_written == 0 and bytes_to_be_written > 0: + raise OSError(self._get_error_message(GetLastError())) + return bytes_written + + +class ConsoleStream: + def __init__(self, text_stream: t.TextIO, byte_stream: t.BinaryIO) -> None: + self._text_stream = text_stream + self.buffer = byte_stream + + @property + def name(self) -> str: + return self.buffer.name + + def write(self, x: t.AnyStr) -> int: + if isinstance(x, str): + return self._text_stream.write(x) + try: + self.flush() + except Exception: + pass + return self.buffer.write(x) + + def writelines(self, lines: t.Iterable[t.AnyStr]) -> None: + for line in lines: + self.write(line) + + def __getattr__(self, name: str) -> t.Any: + return getattr(self._text_stream, name) + + def isatty(self) -> bool: + return self.buffer.isatty() + + def __repr__(self): + return f"" + + +def _get_text_stdin(buffer_stream: t.BinaryIO) -> t.TextIO: + text_stream = _NonClosingTextIOWrapper( + io.BufferedReader(_WindowsConsoleReader(STDIN_HANDLE)), + "utf-16-le", + "strict", + line_buffering=True, + ) + return t.cast(t.TextIO, ConsoleStream(text_stream, buffer_stream)) + + +def _get_text_stdout(buffer_stream: t.BinaryIO) -> t.TextIO: + text_stream = _NonClosingTextIOWrapper( + io.BufferedWriter(_WindowsConsoleWriter(STDOUT_HANDLE)), + "utf-16-le", + "strict", + line_buffering=True, + ) + return t.cast(t.TextIO, ConsoleStream(text_stream, buffer_stream)) + + +def _get_text_stderr(buffer_stream: t.BinaryIO) -> t.TextIO: + text_stream = _NonClosingTextIOWrapper( + io.BufferedWriter(_WindowsConsoleWriter(STDERR_HANDLE)), + "utf-16-le", + "strict", + line_buffering=True, + ) + return t.cast(t.TextIO, ConsoleStream(text_stream, buffer_stream)) + + +_stream_factories: t.Mapping[int, t.Callable[[t.BinaryIO], t.TextIO]] = { + 0: _get_text_stdin, + 1: _get_text_stdout, + 2: _get_text_stderr, +} + + +def _is_console(f: t.TextIO) -> bool: + if not hasattr(f, "fileno"): + return False + + try: + fileno = f.fileno() + except (OSError, io.UnsupportedOperation): + return False + + handle = msvcrt.get_osfhandle(fileno) + return bool(GetConsoleMode(handle, byref(DWORD()))) + + +def _get_windows_console_stream( + f: t.TextIO, encoding: t.Optional[str], errors: t.Optional[str] +) -> t.Optional[t.TextIO]: + if ( + get_buffer is not None + and encoding in {"utf-16-le", None} + and errors in {"strict", None} + and _is_console(f) + ): + func = _stream_factories.get(f.fileno()) + if func is not None: + b = getattr(f, "buffer", None) + + if b is None: + return None + + return func(b) diff --git a/.venv/Lib/site-packages/click/core.py b/.venv/Lib/site-packages/click/core.py new file mode 100644 index 0000000..e630501 --- /dev/null +++ b/.venv/Lib/site-packages/click/core.py @@ -0,0 +1,3047 @@ +import enum +import errno +import inspect +import os +import sys +import typing as t +from collections import abc +from contextlib import contextmanager +from contextlib import ExitStack +from functools import update_wrapper +from gettext import gettext as _ +from gettext import ngettext +from itertools import repeat +from types import TracebackType + +from . import types +from .exceptions import Abort +from .exceptions import BadParameter +from .exceptions import ClickException +from .exceptions import Exit +from .exceptions import MissingParameter +from .exceptions import UsageError +from .formatting import HelpFormatter +from .formatting import join_options +from .globals import pop_context +from .globals import push_context +from .parser import _flag_needs_value +from .parser import OptionParser +from .parser import split_opt +from .termui import confirm +from .termui import prompt +from .termui import style +from .utils import _detect_program_name +from .utils import _expand_args +from .utils import echo +from .utils import make_default_short_help +from .utils import make_str +from .utils import PacifyFlushWrapper + +if t.TYPE_CHECKING: + import typing_extensions as te + + from .decorators import HelpOption + from .shell_completion import CompletionItem + +F = t.TypeVar("F", bound=t.Callable[..., t.Any]) +V = t.TypeVar("V") + + +def _complete_visible_commands( + ctx: "Context", incomplete: str +) -> t.Iterator[t.Tuple[str, "Command"]]: + """List all the subcommands of a group that start with the + incomplete value and aren't hidden. + + :param ctx: Invocation context for the group. + :param incomplete: Value being completed. May be empty. + """ + multi = t.cast(MultiCommand, ctx.command) + + for name in multi.list_commands(ctx): + if name.startswith(incomplete): + command = multi.get_command(ctx, name) + + if command is not None and not command.hidden: + yield name, command + + +def _check_multicommand( + base_command: "MultiCommand", cmd_name: str, cmd: "Command", register: bool = False +) -> None: + if not base_command.chain or not isinstance(cmd, MultiCommand): + return + if register: + hint = ( + "It is not possible to add multi commands as children to" + " another multi command that is in chain mode." + ) + else: + hint = ( + "Found a multi command as subcommand to a multi command" + " that is in chain mode. This is not supported." + ) + raise RuntimeError( + f"{hint}. Command {base_command.name!r} is set to chain and" + f" {cmd_name!r} was added as a subcommand but it in itself is a" + f" multi command. ({cmd_name!r} is a {type(cmd).__name__}" + f" within a chained {type(base_command).__name__} named" + f" {base_command.name!r})." + ) + + +def batch(iterable: t.Iterable[V], batch_size: int) -> t.List[t.Tuple[V, ...]]: + return list(zip(*repeat(iter(iterable), batch_size))) + + +@contextmanager +def augment_usage_errors( + ctx: "Context", param: t.Optional["Parameter"] = None +) -> t.Iterator[None]: + """Context manager that attaches extra information to exceptions.""" + try: + yield + except BadParameter as e: + if e.ctx is None: + e.ctx = ctx + if param is not None and e.param is None: + e.param = param + raise + except UsageError as e: + if e.ctx is None: + e.ctx = ctx + raise + + +def iter_params_for_processing( + invocation_order: t.Sequence["Parameter"], + declaration_order: t.Sequence["Parameter"], +) -> t.List["Parameter"]: + """Returns all declared parameters in the order they should be processed. + + The declared parameters are re-shuffled depending on the order in which + they were invoked, as well as the eagerness of each parameters. + + The invocation order takes precedence over the declaration order. I.e. the + order in which the user provided them to the CLI is respected. + + This behavior and its effect on callback evaluation is detailed at: + https://click.palletsprojects.com/en/stable/advanced/#callback-evaluation-order + """ + + def sort_key(item: "Parameter") -> t.Tuple[bool, float]: + try: + idx: float = invocation_order.index(item) + except ValueError: + idx = float("inf") + + return not item.is_eager, idx + + return sorted(declaration_order, key=sort_key) + + +class ParameterSource(enum.Enum): + """This is an :class:`~enum.Enum` that indicates the source of a + parameter's value. + + Use :meth:`click.Context.get_parameter_source` to get the + source for a parameter by name. + + .. versionchanged:: 8.0 + Use :class:`~enum.Enum` and drop the ``validate`` method. + + .. versionchanged:: 8.0 + Added the ``PROMPT`` value. + """ + + COMMANDLINE = enum.auto() + """The value was provided by the command line args.""" + ENVIRONMENT = enum.auto() + """The value was provided with an environment variable.""" + DEFAULT = enum.auto() + """Used the default specified by the parameter.""" + DEFAULT_MAP = enum.auto() + """Used a default provided by :attr:`Context.default_map`.""" + PROMPT = enum.auto() + """Used a prompt to confirm a default or provide a value.""" + + +class Context: + """The context is a special internal object that holds state relevant + for the script execution at every single level. It's normally invisible + to commands unless they opt-in to getting access to it. + + The context is useful as it can pass internal objects around and can + control special execution features such as reading data from + environment variables. + + A context can be used as context manager in which case it will call + :meth:`close` on teardown. + + :param command: the command class for this context. + :param parent: the parent context. + :param info_name: the info name for this invocation. Generally this + is the most descriptive name for the script or + command. For the toplevel script it is usually + the name of the script, for commands below it it's + the name of the script. + :param obj: an arbitrary object of user data. + :param auto_envvar_prefix: the prefix to use for automatic environment + variables. If this is `None` then reading + from environment variables is disabled. This + does not affect manually set environment + variables which are always read. + :param default_map: a dictionary (like object) with default values + for parameters. + :param terminal_width: the width of the terminal. The default is + inherit from parent context. If no context + defines the terminal width then auto + detection will be applied. + :param max_content_width: the maximum width for content rendered by + Click (this currently only affects help + pages). This defaults to 80 characters if + not overridden. In other words: even if the + terminal is larger than that, Click will not + format things wider than 80 characters by + default. In addition to that, formatters might + add some safety mapping on the right. + :param resilient_parsing: if this flag is enabled then Click will + parse without any interactivity or callback + invocation. Default values will also be + ignored. This is useful for implementing + things such as completion support. + :param allow_extra_args: if this is set to `True` then extra arguments + at the end will not raise an error and will be + kept on the context. The default is to inherit + from the command. + :param allow_interspersed_args: if this is set to `False` then options + and arguments cannot be mixed. The + default is to inherit from the command. + :param ignore_unknown_options: instructs click to ignore options it does + not know and keeps them for later + processing. + :param help_option_names: optionally a list of strings that define how + the default help parameter is named. The + default is ``['--help']``. + :param token_normalize_func: an optional function that is used to + normalize tokens (options, choices, + etc.). This for instance can be used to + implement case insensitive behavior. + :param color: controls if the terminal supports ANSI colors or not. The + default is autodetection. This is only needed if ANSI + codes are used in texts that Click prints which is by + default not the case. This for instance would affect + help output. + :param show_default: Show the default value for commands. If this + value is not set, it defaults to the value from the parent + context. ``Command.show_default`` overrides this default for the + specific command. + + .. versionchanged:: 8.1 + The ``show_default`` parameter is overridden by + ``Command.show_default``, instead of the other way around. + + .. versionchanged:: 8.0 + The ``show_default`` parameter defaults to the value from the + parent context. + + .. versionchanged:: 7.1 + Added the ``show_default`` parameter. + + .. versionchanged:: 4.0 + Added the ``color``, ``ignore_unknown_options``, and + ``max_content_width`` parameters. + + .. versionchanged:: 3.0 + Added the ``allow_extra_args`` and ``allow_interspersed_args`` + parameters. + + .. versionchanged:: 2.0 + Added the ``resilient_parsing``, ``help_option_names``, and + ``token_normalize_func`` parameters. + """ + + #: The formatter class to create with :meth:`make_formatter`. + #: + #: .. versionadded:: 8.0 + formatter_class: t.Type["HelpFormatter"] = HelpFormatter + + def __init__( + self, + command: "Command", + parent: t.Optional["Context"] = None, + info_name: t.Optional[str] = None, + obj: t.Optional[t.Any] = None, + auto_envvar_prefix: t.Optional[str] = None, + default_map: t.Optional[t.MutableMapping[str, t.Any]] = None, + terminal_width: t.Optional[int] = None, + max_content_width: t.Optional[int] = None, + resilient_parsing: bool = False, + allow_extra_args: t.Optional[bool] = None, + allow_interspersed_args: t.Optional[bool] = None, + ignore_unknown_options: t.Optional[bool] = None, + help_option_names: t.Optional[t.List[str]] = None, + token_normalize_func: t.Optional[t.Callable[[str], str]] = None, + color: t.Optional[bool] = None, + show_default: t.Optional[bool] = None, + ) -> None: + #: the parent context or `None` if none exists. + self.parent = parent + #: the :class:`Command` for this context. + self.command = command + #: the descriptive information name + self.info_name = info_name + #: Map of parameter names to their parsed values. Parameters + #: with ``expose_value=False`` are not stored. + self.params: t.Dict[str, t.Any] = {} + #: the leftover arguments. + self.args: t.List[str] = [] + #: protected arguments. These are arguments that are prepended + #: to `args` when certain parsing scenarios are encountered but + #: must be never propagated to another arguments. This is used + #: to implement nested parsing. + self.protected_args: t.List[str] = [] + #: the collected prefixes of the command's options. + self._opt_prefixes: t.Set[str] = set(parent._opt_prefixes) if parent else set() + + if obj is None and parent is not None: + obj = parent.obj + + #: the user object stored. + self.obj: t.Any = obj + self._meta: t.Dict[str, t.Any] = getattr(parent, "meta", {}) + + #: A dictionary (-like object) with defaults for parameters. + if ( + default_map is None + and info_name is not None + and parent is not None + and parent.default_map is not None + ): + default_map = parent.default_map.get(info_name) + + self.default_map: t.Optional[t.MutableMapping[str, t.Any]] = default_map + + #: This flag indicates if a subcommand is going to be executed. A + #: group callback can use this information to figure out if it's + #: being executed directly or because the execution flow passes + #: onwards to a subcommand. By default it's None, but it can be + #: the name of the subcommand to execute. + #: + #: If chaining is enabled this will be set to ``'*'`` in case + #: any commands are executed. It is however not possible to + #: figure out which ones. If you require this knowledge you + #: should use a :func:`result_callback`. + self.invoked_subcommand: t.Optional[str] = None + + if terminal_width is None and parent is not None: + terminal_width = parent.terminal_width + + #: The width of the terminal (None is autodetection). + self.terminal_width: t.Optional[int] = terminal_width + + if max_content_width is None and parent is not None: + max_content_width = parent.max_content_width + + #: The maximum width of formatted content (None implies a sensible + #: default which is 80 for most things). + self.max_content_width: t.Optional[int] = max_content_width + + if allow_extra_args is None: + allow_extra_args = command.allow_extra_args + + #: Indicates if the context allows extra args or if it should + #: fail on parsing. + #: + #: .. versionadded:: 3.0 + self.allow_extra_args = allow_extra_args + + if allow_interspersed_args is None: + allow_interspersed_args = command.allow_interspersed_args + + #: Indicates if the context allows mixing of arguments and + #: options or not. + #: + #: .. versionadded:: 3.0 + self.allow_interspersed_args: bool = allow_interspersed_args + + if ignore_unknown_options is None: + ignore_unknown_options = command.ignore_unknown_options + + #: Instructs click to ignore options that a command does not + #: understand and will store it on the context for later + #: processing. This is primarily useful for situations where you + #: want to call into external programs. Generally this pattern is + #: strongly discouraged because it's not possibly to losslessly + #: forward all arguments. + #: + #: .. versionadded:: 4.0 + self.ignore_unknown_options: bool = ignore_unknown_options + + if help_option_names is None: + if parent is not None: + help_option_names = parent.help_option_names + else: + help_option_names = ["--help"] + + #: The names for the help options. + self.help_option_names: t.List[str] = help_option_names + + if token_normalize_func is None and parent is not None: + token_normalize_func = parent.token_normalize_func + + #: An optional normalization function for tokens. This is + #: options, choices, commands etc. + self.token_normalize_func: t.Optional[t.Callable[[str], str]] = ( + token_normalize_func + ) + + #: Indicates if resilient parsing is enabled. In that case Click + #: will do its best to not cause any failures and default values + #: will be ignored. Useful for completion. + self.resilient_parsing: bool = resilient_parsing + + # If there is no envvar prefix yet, but the parent has one and + # the command on this level has a name, we can expand the envvar + # prefix automatically. + if auto_envvar_prefix is None: + if ( + parent is not None + and parent.auto_envvar_prefix is not None + and self.info_name is not None + ): + auto_envvar_prefix = ( + f"{parent.auto_envvar_prefix}_{self.info_name.upper()}" + ) + else: + auto_envvar_prefix = auto_envvar_prefix.upper() + + if auto_envvar_prefix is not None: + auto_envvar_prefix = auto_envvar_prefix.replace("-", "_") + + self.auto_envvar_prefix: t.Optional[str] = auto_envvar_prefix + + if color is None and parent is not None: + color = parent.color + + #: Controls if styling output is wanted or not. + self.color: t.Optional[bool] = color + + if show_default is None and parent is not None: + show_default = parent.show_default + + #: Show option default values when formatting help text. + self.show_default: t.Optional[bool] = show_default + + self._close_callbacks: t.List[t.Callable[[], t.Any]] = [] + self._depth = 0 + self._parameter_source: t.Dict[str, ParameterSource] = {} + self._exit_stack = ExitStack() + + def to_info_dict(self) -> t.Dict[str, t.Any]: + """Gather information that could be useful for a tool generating + user-facing documentation. This traverses the entire CLI + structure. + + .. code-block:: python + + with Context(cli) as ctx: + info = ctx.to_info_dict() + + .. versionadded:: 8.0 + """ + return { + "command": self.command.to_info_dict(self), + "info_name": self.info_name, + "allow_extra_args": self.allow_extra_args, + "allow_interspersed_args": self.allow_interspersed_args, + "ignore_unknown_options": self.ignore_unknown_options, + "auto_envvar_prefix": self.auto_envvar_prefix, + } + + def __enter__(self) -> "Context": + self._depth += 1 + push_context(self) + return self + + def __exit__( + self, + exc_type: t.Optional[t.Type[BaseException]], + exc_value: t.Optional[BaseException], + tb: t.Optional[TracebackType], + ) -> None: + self._depth -= 1 + if self._depth == 0: + self.close() + pop_context() + + @contextmanager + def scope(self, cleanup: bool = True) -> t.Iterator["Context"]: + """This helper method can be used with the context object to promote + it to the current thread local (see :func:`get_current_context`). + The default behavior of this is to invoke the cleanup functions which + can be disabled by setting `cleanup` to `False`. The cleanup + functions are typically used for things such as closing file handles. + + If the cleanup is intended the context object can also be directly + used as a context manager. + + Example usage:: + + with ctx.scope(): + assert get_current_context() is ctx + + This is equivalent:: + + with ctx: + assert get_current_context() is ctx + + .. versionadded:: 5.0 + + :param cleanup: controls if the cleanup functions should be run or + not. The default is to run these functions. In + some situations the context only wants to be + temporarily pushed in which case this can be disabled. + Nested pushes automatically defer the cleanup. + """ + if not cleanup: + self._depth += 1 + try: + with self as rv: + yield rv + finally: + if not cleanup: + self._depth -= 1 + + @property + def meta(self) -> t.Dict[str, t.Any]: + """This is a dictionary which is shared with all the contexts + that are nested. It exists so that click utilities can store some + state here if they need to. It is however the responsibility of + that code to manage this dictionary well. + + The keys are supposed to be unique dotted strings. For instance + module paths are a good choice for it. What is stored in there is + irrelevant for the operation of click. However what is important is + that code that places data here adheres to the general semantics of + the system. + + Example usage:: + + LANG_KEY = f'{__name__}.lang' + + def set_language(value): + ctx = get_current_context() + ctx.meta[LANG_KEY] = value + + def get_language(): + return get_current_context().meta.get(LANG_KEY, 'en_US') + + .. versionadded:: 5.0 + """ + return self._meta + + def make_formatter(self) -> HelpFormatter: + """Creates the :class:`~click.HelpFormatter` for the help and + usage output. + + To quickly customize the formatter class used without overriding + this method, set the :attr:`formatter_class` attribute. + + .. versionchanged:: 8.0 + Added the :attr:`formatter_class` attribute. + """ + return self.formatter_class( + width=self.terminal_width, max_width=self.max_content_width + ) + + def with_resource(self, context_manager: t.ContextManager[V]) -> V: + """Register a resource as if it were used in a ``with`` + statement. The resource will be cleaned up when the context is + popped. + + Uses :meth:`contextlib.ExitStack.enter_context`. It calls the + resource's ``__enter__()`` method and returns the result. When + the context is popped, it closes the stack, which calls the + resource's ``__exit__()`` method. + + To register a cleanup function for something that isn't a + context manager, use :meth:`call_on_close`. Or use something + from :mod:`contextlib` to turn it into a context manager first. + + .. code-block:: python + + @click.group() + @click.option("--name") + @click.pass_context + def cli(ctx): + ctx.obj = ctx.with_resource(connect_db(name)) + + :param context_manager: The context manager to enter. + :return: Whatever ``context_manager.__enter__()`` returns. + + .. versionadded:: 8.0 + """ + return self._exit_stack.enter_context(context_manager) + + def call_on_close(self, f: t.Callable[..., t.Any]) -> t.Callable[..., t.Any]: + """Register a function to be called when the context tears down. + + This can be used to close resources opened during the script + execution. Resources that support Python's context manager + protocol which would be used in a ``with`` statement should be + registered with :meth:`with_resource` instead. + + :param f: The function to execute on teardown. + """ + return self._exit_stack.callback(f) + + def close(self) -> None: + """Invoke all close callbacks registered with + :meth:`call_on_close`, and exit all context managers entered + with :meth:`with_resource`. + """ + self._exit_stack.close() + # In case the context is reused, create a new exit stack. + self._exit_stack = ExitStack() + + @property + def command_path(self) -> str: + """The computed command path. This is used for the ``usage`` + information on the help page. It's automatically created by + combining the info names of the chain of contexts to the root. + """ + rv = "" + if self.info_name is not None: + rv = self.info_name + if self.parent is not None: + parent_command_path = [self.parent.command_path] + + if isinstance(self.parent.command, Command): + for param in self.parent.command.get_params(self): + parent_command_path.extend(param.get_usage_pieces(self)) + + rv = f"{' '.join(parent_command_path)} {rv}" + return rv.lstrip() + + def find_root(self) -> "Context": + """Finds the outermost context.""" + node = self + while node.parent is not None: + node = node.parent + return node + + def find_object(self, object_type: t.Type[V]) -> t.Optional[V]: + """Finds the closest object of a given type.""" + node: t.Optional[Context] = self + + while node is not None: + if isinstance(node.obj, object_type): + return node.obj + + node = node.parent + + return None + + def ensure_object(self, object_type: t.Type[V]) -> V: + """Like :meth:`find_object` but sets the innermost object to a + new instance of `object_type` if it does not exist. + """ + rv = self.find_object(object_type) + if rv is None: + self.obj = rv = object_type() + return rv + + @t.overload + def lookup_default( + self, name: str, call: "te.Literal[True]" = True + ) -> t.Optional[t.Any]: ... + + @t.overload + def lookup_default( + self, name: str, call: "te.Literal[False]" = ... + ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]: ... + + def lookup_default(self, name: str, call: bool = True) -> t.Optional[t.Any]: + """Get the default for a parameter from :attr:`default_map`. + + :param name: Name of the parameter. + :param call: If the default is a callable, call it. Disable to + return the callable instead. + + .. versionchanged:: 8.0 + Added the ``call`` parameter. + """ + if self.default_map is not None: + value = self.default_map.get(name) + + if call and callable(value): + return value() + + return value + + return None + + def fail(self, message: str) -> "te.NoReturn": + """Aborts the execution of the program with a specific error + message. + + :param message: the error message to fail with. + """ + raise UsageError(message, self) + + def abort(self) -> "te.NoReturn": + """Aborts the script.""" + raise Abort() + + def exit(self, code: int = 0) -> "te.NoReturn": + """Exits the application with a given exit code.""" + raise Exit(code) + + def get_usage(self) -> str: + """Helper method to get formatted usage string for the current + context and command. + """ + return self.command.get_usage(self) + + def get_help(self) -> str: + """Helper method to get formatted help page for the current + context and command. + """ + return self.command.get_help(self) + + def _make_sub_context(self, command: "Command") -> "Context": + """Create a new context of the same type as this context, but + for a new command. + + :meta private: + """ + return type(self)(command, info_name=command.name, parent=self) + + @t.overload + def invoke( + __self, + __callback: "t.Callable[..., V]", + *args: t.Any, + **kwargs: t.Any, + ) -> V: ... + + @t.overload + def invoke( + __self, + __callback: "Command", + *args: t.Any, + **kwargs: t.Any, + ) -> t.Any: ... + + def invoke( + __self, + __callback: t.Union["Command", "t.Callable[..., V]"], + *args: t.Any, + **kwargs: t.Any, + ) -> t.Union[t.Any, V]: + """Invokes a command callback in exactly the way it expects. There + are two ways to invoke this method: + + 1. the first argument can be a callback and all other arguments and + keyword arguments are forwarded directly to the function. + 2. the first argument is a click command object. In that case all + arguments are forwarded as well but proper click parameters + (options and click arguments) must be keyword arguments and Click + will fill in defaults. + + Note that before Click 3.2 keyword arguments were not properly filled + in against the intention of this code and no context was created. For + more information about this change and why it was done in a bugfix + release see :ref:`upgrade-to-3.2`. + + .. versionchanged:: 8.0 + All ``kwargs`` are tracked in :attr:`params` so they will be + passed if :meth:`forward` is called at multiple levels. + """ + if isinstance(__callback, Command): + other_cmd = __callback + + if other_cmd.callback is None: + raise TypeError( + "The given command does not have a callback that can be invoked." + ) + else: + __callback = t.cast("t.Callable[..., V]", other_cmd.callback) + + ctx = __self._make_sub_context(other_cmd) + + for param in other_cmd.params: + if param.name not in kwargs and param.expose_value: + kwargs[param.name] = param.type_cast_value( # type: ignore + ctx, param.get_default(ctx) + ) + + # Track all kwargs as params, so that forward() will pass + # them on in subsequent calls. + ctx.params.update(kwargs) + else: + ctx = __self + + with augment_usage_errors(__self): + with ctx: + return __callback(*args, **kwargs) + + def forward(__self, __cmd: "Command", *args: t.Any, **kwargs: t.Any) -> t.Any: + """Similar to :meth:`invoke` but fills in default keyword + arguments from the current context if the other command expects + it. This cannot invoke callbacks directly, only other commands. + + .. versionchanged:: 8.0 + All ``kwargs`` are tracked in :attr:`params` so they will be + passed if ``forward`` is called at multiple levels. + """ + # Can only forward to other commands, not direct callbacks. + if not isinstance(__cmd, Command): + raise TypeError("Callback is not a command.") + + for param in __self.params: + if param not in kwargs: + kwargs[param] = __self.params[param] + + return __self.invoke(__cmd, *args, **kwargs) + + def set_parameter_source(self, name: str, source: ParameterSource) -> None: + """Set the source of a parameter. This indicates the location + from which the value of the parameter was obtained. + + :param name: The name of the parameter. + :param source: A member of :class:`~click.core.ParameterSource`. + """ + self._parameter_source[name] = source + + def get_parameter_source(self, name: str) -> t.Optional[ParameterSource]: + """Get the source of a parameter. This indicates the location + from which the value of the parameter was obtained. + + This can be useful for determining when a user specified a value + on the command line that is the same as the default value. It + will be :attr:`~click.core.ParameterSource.DEFAULT` only if the + value was actually taken from the default. + + :param name: The name of the parameter. + :rtype: ParameterSource + + .. versionchanged:: 8.0 + Returns ``None`` if the parameter was not provided from any + source. + """ + return self._parameter_source.get(name) + + +class BaseCommand: + """The base command implements the minimal API contract of commands. + Most code will never use this as it does not implement a lot of useful + functionality but it can act as the direct subclass of alternative + parsing methods that do not depend on the Click parser. + + For instance, this can be used to bridge Click and other systems like + argparse or docopt. + + Because base commands do not implement a lot of the API that other + parts of Click take for granted, they are not supported for all + operations. For instance, they cannot be used with the decorators + usually and they have no built-in callback system. + + .. versionchanged:: 2.0 + Added the `context_settings` parameter. + + :param name: the name of the command to use unless a group overrides it. + :param context_settings: an optional dictionary with defaults that are + passed to the context object. + """ + + #: The context class to create with :meth:`make_context`. + #: + #: .. versionadded:: 8.0 + context_class: t.Type[Context] = Context + #: the default for the :attr:`Context.allow_extra_args` flag. + allow_extra_args = False + #: the default for the :attr:`Context.allow_interspersed_args` flag. + allow_interspersed_args = True + #: the default for the :attr:`Context.ignore_unknown_options` flag. + ignore_unknown_options = False + + def __init__( + self, + name: t.Optional[str], + context_settings: t.Optional[t.MutableMapping[str, t.Any]] = None, + ) -> None: + #: the name the command thinks it has. Upon registering a command + #: on a :class:`Group` the group will default the command name + #: with this information. You should instead use the + #: :class:`Context`\'s :attr:`~Context.info_name` attribute. + self.name = name + + if context_settings is None: + context_settings = {} + + #: an optional dictionary with defaults passed to the context. + self.context_settings: t.MutableMapping[str, t.Any] = context_settings + + def to_info_dict(self, ctx: Context) -> t.Dict[str, t.Any]: + """Gather information that could be useful for a tool generating + user-facing documentation. This traverses the entire structure + below this command. + + Use :meth:`click.Context.to_info_dict` to traverse the entire + CLI structure. + + :param ctx: A :class:`Context` representing this command. + + .. versionadded:: 8.0 + """ + return {"name": self.name} + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self.name}>" + + def get_usage(self, ctx: Context) -> str: + raise NotImplementedError("Base commands cannot get usage") + + def get_help(self, ctx: Context) -> str: + raise NotImplementedError("Base commands cannot get help") + + def make_context( + self, + info_name: t.Optional[str], + args: t.List[str], + parent: t.Optional[Context] = None, + **extra: t.Any, + ) -> Context: + """This function when given an info name and arguments will kick + off the parsing and create a new :class:`Context`. It does not + invoke the actual command callback though. + + To quickly customize the context class used without overriding + this method, set the :attr:`context_class` attribute. + + :param info_name: the info name for this invocation. Generally this + is the most descriptive name for the script or + command. For the toplevel script it's usually + the name of the script, for commands below it's + the name of the command. + :param args: the arguments to parse as list of strings. + :param parent: the parent context if available. + :param extra: extra keyword arguments forwarded to the context + constructor. + + .. versionchanged:: 8.0 + Added the :attr:`context_class` attribute. + """ + for key, value in self.context_settings.items(): + if key not in extra: + extra[key] = value + + ctx = self.context_class( + self, # type: ignore[arg-type] + info_name=info_name, + parent=parent, + **extra, + ) + + with ctx.scope(cleanup=False): + self.parse_args(ctx, args) + return ctx + + def parse_args(self, ctx: Context, args: t.List[str]) -> t.List[str]: + """Given a context and a list of arguments this creates the parser + and parses the arguments, then modifies the context as necessary. + This is automatically invoked by :meth:`make_context`. + """ + raise NotImplementedError("Base commands do not know how to parse arguments.") + + def invoke(self, ctx: Context) -> t.Any: + """Given a context, this invokes the command. The default + implementation is raising a not implemented error. + """ + raise NotImplementedError("Base commands are not invocable by default") + + def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]: + """Return a list of completions for the incomplete value. Looks + at the names of chained multi-commands. + + Any command could be part of a chained multi-command, so sibling + commands are valid at any point during command completion. Other + command classes will return more completions. + + :param ctx: Invocation context for this command. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + from click.shell_completion import CompletionItem + + results: t.List[CompletionItem] = [] + + while ctx.parent is not None: + ctx = ctx.parent + + if isinstance(ctx.command, MultiCommand) and ctx.command.chain: + results.extend( + CompletionItem(name, help=command.get_short_help_str()) + for name, command in _complete_visible_commands(ctx, incomplete) + if name not in ctx.protected_args + ) + + return results + + @t.overload + def main( + self, + args: t.Optional[t.Sequence[str]] = None, + prog_name: t.Optional[str] = None, + complete_var: t.Optional[str] = None, + standalone_mode: "te.Literal[True]" = True, + **extra: t.Any, + ) -> "te.NoReturn": ... + + @t.overload + def main( + self, + args: t.Optional[t.Sequence[str]] = None, + prog_name: t.Optional[str] = None, + complete_var: t.Optional[str] = None, + standalone_mode: bool = ..., + **extra: t.Any, + ) -> t.Any: ... + + def main( + self, + args: t.Optional[t.Sequence[str]] = None, + prog_name: t.Optional[str] = None, + complete_var: t.Optional[str] = None, + standalone_mode: bool = True, + windows_expand_args: bool = True, + **extra: t.Any, + ) -> t.Any: + """This is the way to invoke a script with all the bells and + whistles as a command line application. This will always terminate + the application after a call. If this is not wanted, ``SystemExit`` + needs to be caught. + + This method is also available by directly calling the instance of + a :class:`Command`. + + :param args: the arguments that should be used for parsing. If not + provided, ``sys.argv[1:]`` is used. + :param prog_name: the program name that should be used. By default + the program name is constructed by taking the file + name from ``sys.argv[0]``. + :param complete_var: the environment variable that controls the + bash completion support. The default is + ``"__COMPLETE"`` with prog_name in + uppercase. + :param standalone_mode: the default behavior is to invoke the script + in standalone mode. Click will then + handle exceptions and convert them into + error messages and the function will never + return but shut down the interpreter. If + this is set to `False` they will be + propagated to the caller and the return + value of this function is the return value + of :meth:`invoke`. + :param windows_expand_args: Expand glob patterns, user dir, and + env vars in command line args on Windows. + :param extra: extra keyword arguments are forwarded to the context + constructor. See :class:`Context` for more information. + + .. versionchanged:: 8.0.1 + Added the ``windows_expand_args`` parameter to allow + disabling command line arg expansion on Windows. + + .. versionchanged:: 8.0 + When taking arguments from ``sys.argv`` on Windows, glob + patterns, user dir, and env vars are expanded. + + .. versionchanged:: 3.0 + Added the ``standalone_mode`` parameter. + """ + if args is None: + args = sys.argv[1:] + + if os.name == "nt" and windows_expand_args: + args = _expand_args(args) + else: + args = list(args) + + if prog_name is None: + prog_name = _detect_program_name() + + # Process shell completion requests and exit early. + self._main_shell_completion(extra, prog_name, complete_var) + + try: + try: + with self.make_context(prog_name, args, **extra) as ctx: + rv = self.invoke(ctx) + if not standalone_mode: + return rv + # it's not safe to `ctx.exit(rv)` here! + # note that `rv` may actually contain data like "1" which + # has obvious effects + # more subtle case: `rv=[None, None]` can come out of + # chained commands which all returned `None` -- so it's not + # even always obvious that `rv` indicates success/failure + # by its truthiness/falsiness + ctx.exit() + except (EOFError, KeyboardInterrupt) as e: + echo(file=sys.stderr) + raise Abort() from e + except ClickException as e: + if not standalone_mode: + raise + e.show() + sys.exit(e.exit_code) + except OSError as e: + if e.errno == errno.EPIPE: + sys.stdout = t.cast(t.TextIO, PacifyFlushWrapper(sys.stdout)) + sys.stderr = t.cast(t.TextIO, PacifyFlushWrapper(sys.stderr)) + sys.exit(1) + else: + raise + except Exit as e: + if standalone_mode: + sys.exit(e.exit_code) + else: + # in non-standalone mode, return the exit code + # note that this is only reached if `self.invoke` above raises + # an Exit explicitly -- thus bypassing the check there which + # would return its result + # the results of non-standalone execution may therefore be + # somewhat ambiguous: if there are codepaths which lead to + # `ctx.exit(1)` and to `return 1`, the caller won't be able to + # tell the difference between the two + return e.exit_code + except Abort: + if not standalone_mode: + raise + echo(_("Aborted!"), file=sys.stderr) + sys.exit(1) + + def _main_shell_completion( + self, + ctx_args: t.MutableMapping[str, t.Any], + prog_name: str, + complete_var: t.Optional[str] = None, + ) -> None: + """Check if the shell is asking for tab completion, process + that, then exit early. Called from :meth:`main` before the + program is invoked. + + :param prog_name: Name of the executable in the shell. + :param complete_var: Name of the environment variable that holds + the completion instruction. Defaults to + ``_{PROG_NAME}_COMPLETE``. + + .. versionchanged:: 8.2.0 + Dots (``.``) in ``prog_name`` are replaced with underscores (``_``). + """ + if complete_var is None: + complete_name = prog_name.replace("-", "_").replace(".", "_") + complete_var = f"_{complete_name}_COMPLETE".upper() + + instruction = os.environ.get(complete_var) + + if not instruction: + return + + from .shell_completion import shell_complete + + rv = shell_complete(self, ctx_args, prog_name, complete_var, instruction) + sys.exit(rv) + + def __call__(self, *args: t.Any, **kwargs: t.Any) -> t.Any: + """Alias for :meth:`main`.""" + return self.main(*args, **kwargs) + + +class Command(BaseCommand): + """Commands are the basic building block of command line interfaces in + Click. A basic command handles command line parsing and might dispatch + more parsing to commands nested below it. + + :param name: the name of the command to use unless a group overrides it. + :param context_settings: an optional dictionary with defaults that are + passed to the context object. + :param callback: the callback to invoke. This is optional. + :param params: the parameters to register with this command. This can + be either :class:`Option` or :class:`Argument` objects. + :param help: the help string to use for this command. + :param epilog: like the help string but it's printed at the end of the + help page after everything else. + :param short_help: the short help to use for this command. This is + shown on the command listing of the parent command. + :param add_help_option: by default each command registers a ``--help`` + option. This can be disabled by this parameter. + :param no_args_is_help: this controls what happens if no arguments are + provided. This option is disabled by default. + If enabled this will add ``--help`` as argument + if no arguments are passed + :param hidden: hide this command from help outputs. + + :param deprecated: issues a message indicating that + the command is deprecated. + + .. versionchanged:: 8.1 + ``help``, ``epilog``, and ``short_help`` are stored unprocessed, + all formatting is done when outputting help text, not at init, + and is done even if not using the ``@command`` decorator. + + .. versionchanged:: 8.0 + Added a ``repr`` showing the command name. + + .. versionchanged:: 7.1 + Added the ``no_args_is_help`` parameter. + + .. versionchanged:: 2.0 + Added the ``context_settings`` parameter. + """ + + def __init__( + self, + name: t.Optional[str], + context_settings: t.Optional[t.MutableMapping[str, t.Any]] = None, + callback: t.Optional[t.Callable[..., t.Any]] = None, + params: t.Optional[t.List["Parameter"]] = None, + help: t.Optional[str] = None, + epilog: t.Optional[str] = None, + short_help: t.Optional[str] = None, + options_metavar: t.Optional[str] = "[OPTIONS]", + add_help_option: bool = True, + no_args_is_help: bool = False, + hidden: bool = False, + deprecated: bool = False, + ) -> None: + super().__init__(name, context_settings) + #: the callback to execute when the command fires. This might be + #: `None` in which case nothing happens. + self.callback = callback + #: the list of parameters for this command in the order they + #: should show up in the help page and execute. Eager parameters + #: will automatically be handled before non eager ones. + self.params: t.List[Parameter] = params or [] + self.help = help + self.epilog = epilog + self.options_metavar = options_metavar + self.short_help = short_help + self.add_help_option = add_help_option + self._help_option: t.Optional[HelpOption] = None + self.no_args_is_help = no_args_is_help + self.hidden = hidden + self.deprecated = deprecated + + def to_info_dict(self, ctx: Context) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict(ctx) + info_dict.update( + params=[param.to_info_dict() for param in self.get_params(ctx)], + help=self.help, + epilog=self.epilog, + short_help=self.short_help, + hidden=self.hidden, + deprecated=self.deprecated, + ) + return info_dict + + def get_usage(self, ctx: Context) -> str: + """Formats the usage line into a string and returns it. + + Calls :meth:`format_usage` internally. + """ + formatter = ctx.make_formatter() + self.format_usage(ctx, formatter) + return formatter.getvalue().rstrip("\n") + + def get_params(self, ctx: Context) -> t.List["Parameter"]: + rv = self.params + help_option = self.get_help_option(ctx) + + if help_option is not None: + rv = [*rv, help_option] + + return rv + + def format_usage(self, ctx: Context, formatter: HelpFormatter) -> None: + """Writes the usage line into the formatter. + + This is a low-level method called by :meth:`get_usage`. + """ + pieces = self.collect_usage_pieces(ctx) + formatter.write_usage(ctx.command_path, " ".join(pieces)) + + def collect_usage_pieces(self, ctx: Context) -> t.List[str]: + """Returns all the pieces that go into the usage line and returns + it as a list of strings. + """ + rv = [self.options_metavar] if self.options_metavar else [] + + for param in self.get_params(ctx): + rv.extend(param.get_usage_pieces(ctx)) + + return rv + + def get_help_option_names(self, ctx: Context) -> t.List[str]: + """Returns the names for the help option.""" + all_names = set(ctx.help_option_names) + for param in self.params: + all_names.difference_update(param.opts) + all_names.difference_update(param.secondary_opts) + return list(all_names) + + def get_help_option(self, ctx: Context) -> t.Optional["Option"]: + """Returns the help option object. + + Unless ``add_help_option`` is ``False``. + + .. versionchanged:: 8.1.8 + The help option is now cached to avoid creating it multiple times. + """ + help_options = self.get_help_option_names(ctx) + + if not help_options or not self.add_help_option: + return None + + # Cache the help option object in private _help_option attribute to + # avoid creating it multiple times. Not doing this will break the + # callback odering by iter_params_for_processing(), which relies on + # object comparison. + if self._help_option is None: + # Avoid circular import. + from .decorators import HelpOption + + self._help_option = HelpOption(help_options) + + return self._help_option + + def make_parser(self, ctx: Context) -> OptionParser: + """Creates the underlying option parser for this command.""" + parser = OptionParser(ctx) + for param in self.get_params(ctx): + param.add_to_parser(parser, ctx) + return parser + + def get_help(self, ctx: Context) -> str: + """Formats the help into a string and returns it. + + Calls :meth:`format_help` internally. + """ + formatter = ctx.make_formatter() + self.format_help(ctx, formatter) + return formatter.getvalue().rstrip("\n") + + def get_short_help_str(self, limit: int = 45) -> str: + """Gets short help for the command or makes it by shortening the + long help string. + """ + if self.short_help: + text = inspect.cleandoc(self.short_help) + elif self.help: + text = make_default_short_help(self.help, limit) + else: + text = "" + + if self.deprecated: + text = _("(Deprecated) {text}").format(text=text) + + return text.strip() + + def format_help(self, ctx: Context, formatter: HelpFormatter) -> None: + """Writes the help into the formatter if it exists. + + This is a low-level method called by :meth:`get_help`. + + This calls the following methods: + + - :meth:`format_usage` + - :meth:`format_help_text` + - :meth:`format_options` + - :meth:`format_epilog` + """ + self.format_usage(ctx, formatter) + self.format_help_text(ctx, formatter) + self.format_options(ctx, formatter) + self.format_epilog(ctx, formatter) + + def format_help_text(self, ctx: Context, formatter: HelpFormatter) -> None: + """Writes the help text to the formatter if it exists.""" + if self.help is not None: + # truncate the help text to the first form feed + text = inspect.cleandoc(self.help).partition("\f")[0] + else: + text = "" + + if self.deprecated: + text = _("(Deprecated) {text}").format(text=text) + + if text: + formatter.write_paragraph() + + with formatter.indentation(): + formatter.write_text(text) + + def format_options(self, ctx: Context, formatter: HelpFormatter) -> None: + """Writes all the options into the formatter if they exist.""" + opts = [] + for param in self.get_params(ctx): + rv = param.get_help_record(ctx) + if rv is not None: + opts.append(rv) + + if opts: + with formatter.section(_("Options")): + formatter.write_dl(opts) + + def format_epilog(self, ctx: Context, formatter: HelpFormatter) -> None: + """Writes the epilog into the formatter if it exists.""" + if self.epilog: + epilog = inspect.cleandoc(self.epilog) + formatter.write_paragraph() + + with formatter.indentation(): + formatter.write_text(epilog) + + def parse_args(self, ctx: Context, args: t.List[str]) -> t.List[str]: + if not args and self.no_args_is_help and not ctx.resilient_parsing: + echo(ctx.get_help(), color=ctx.color) + ctx.exit() + + parser = self.make_parser(ctx) + opts, args, param_order = parser.parse_args(args=args) + + for param in iter_params_for_processing(param_order, self.get_params(ctx)): + value, args = param.handle_parse_result(ctx, opts, args) + + if args and not ctx.allow_extra_args and not ctx.resilient_parsing: + ctx.fail( + ngettext( + "Got unexpected extra argument ({args})", + "Got unexpected extra arguments ({args})", + len(args), + ).format(args=" ".join(map(str, args))) + ) + + ctx.args = args + ctx._opt_prefixes.update(parser._opt_prefixes) + return args + + def invoke(self, ctx: Context) -> t.Any: + """Given a context, this invokes the attached callback (if it exists) + in the right way. + """ + if self.deprecated: + message = _( + "DeprecationWarning: The command {name!r} is deprecated." + ).format(name=self.name) + echo(style(message, fg="red"), err=True) + + if self.callback is not None: + return ctx.invoke(self.callback, **ctx.params) + + def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]: + """Return a list of completions for the incomplete value. Looks + at the names of options and chained multi-commands. + + :param ctx: Invocation context for this command. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + from click.shell_completion import CompletionItem + + results: t.List[CompletionItem] = [] + + if incomplete and not incomplete[0].isalnum(): + for param in self.get_params(ctx): + if ( + not isinstance(param, Option) + or param.hidden + or ( + not param.multiple + and ctx.get_parameter_source(param.name) # type: ignore + is ParameterSource.COMMANDLINE + ) + ): + continue + + results.extend( + CompletionItem(name, help=param.help) + for name in [*param.opts, *param.secondary_opts] + if name.startswith(incomplete) + ) + + results.extend(super().shell_complete(ctx, incomplete)) + return results + + +class MultiCommand(Command): + """A multi command is the basic implementation of a command that + dispatches to subcommands. The most common version is the + :class:`Group`. + + :param invoke_without_command: this controls how the multi command itself + is invoked. By default it's only invoked + if a subcommand is provided. + :param no_args_is_help: this controls what happens if no arguments are + provided. This option is enabled by default if + `invoke_without_command` is disabled or disabled + if it's enabled. If enabled this will add + ``--help`` as argument if no arguments are + passed. + :param subcommand_metavar: the string that is used in the documentation + to indicate the subcommand place. + :param chain: if this is set to `True` chaining of multiple subcommands + is enabled. This restricts the form of commands in that + they cannot have optional arguments but it allows + multiple commands to be chained together. + :param result_callback: The result callback to attach to this multi + command. This can be set or changed later with the + :meth:`result_callback` decorator. + :param attrs: Other command arguments described in :class:`Command`. + """ + + allow_extra_args = True + allow_interspersed_args = False + + def __init__( + self, + name: t.Optional[str] = None, + invoke_without_command: bool = False, + no_args_is_help: t.Optional[bool] = None, + subcommand_metavar: t.Optional[str] = None, + chain: bool = False, + result_callback: t.Optional[t.Callable[..., t.Any]] = None, + **attrs: t.Any, + ) -> None: + super().__init__(name, **attrs) + + if no_args_is_help is None: + no_args_is_help = not invoke_without_command + + self.no_args_is_help = no_args_is_help + self.invoke_without_command = invoke_without_command + + if subcommand_metavar is None: + if chain: + subcommand_metavar = "COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]..." + else: + subcommand_metavar = "COMMAND [ARGS]..." + + self.subcommand_metavar = subcommand_metavar + self.chain = chain + # The result callback that is stored. This can be set or + # overridden with the :func:`result_callback` decorator. + self._result_callback = result_callback + + if self.chain: + for param in self.params: + if isinstance(param, Argument) and not param.required: + raise RuntimeError( + "Multi commands in chain mode cannot have" + " optional arguments." + ) + + def to_info_dict(self, ctx: Context) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict(ctx) + commands = {} + + for name in self.list_commands(ctx): + command = self.get_command(ctx, name) + + if command is None: + continue + + sub_ctx = ctx._make_sub_context(command) + + with sub_ctx.scope(cleanup=False): + commands[name] = command.to_info_dict(sub_ctx) + + info_dict.update(commands=commands, chain=self.chain) + return info_dict + + def collect_usage_pieces(self, ctx: Context) -> t.List[str]: + rv = super().collect_usage_pieces(ctx) + rv.append(self.subcommand_metavar) + return rv + + def format_options(self, ctx: Context, formatter: HelpFormatter) -> None: + super().format_options(ctx, formatter) + self.format_commands(ctx, formatter) + + def result_callback(self, replace: bool = False) -> t.Callable[[F], F]: + """Adds a result callback to the command. By default if a + result callback is already registered this will chain them but + this can be disabled with the `replace` parameter. The result + callback is invoked with the return value of the subcommand + (or the list of return values from all subcommands if chaining + is enabled) as well as the parameters as they would be passed + to the main callback. + + Example:: + + @click.group() + @click.option('-i', '--input', default=23) + def cli(input): + return 42 + + @cli.result_callback() + def process_result(result, input): + return result + input + + :param replace: if set to `True` an already existing result + callback will be removed. + + .. versionchanged:: 8.0 + Renamed from ``resultcallback``. + + .. versionadded:: 3.0 + """ + + def decorator(f: F) -> F: + old_callback = self._result_callback + + if old_callback is None or replace: + self._result_callback = f + return f + + def function(__value, *args, **kwargs): # type: ignore + inner = old_callback(__value, *args, **kwargs) + return f(inner, *args, **kwargs) + + self._result_callback = rv = update_wrapper(t.cast(F, function), f) + return rv # type: ignore[return-value] + + return decorator + + def format_commands(self, ctx: Context, formatter: HelpFormatter) -> None: + """Extra format methods for multi methods that adds all the commands + after the options. + """ + commands = [] + for subcommand in self.list_commands(ctx): + cmd = self.get_command(ctx, subcommand) + # What is this, the tool lied about a command. Ignore it + if cmd is None: + continue + if cmd.hidden: + continue + + commands.append((subcommand, cmd)) + + # allow for 3 times the default spacing + if len(commands): + limit = formatter.width - 6 - max(len(cmd[0]) for cmd in commands) + + rows = [] + for subcommand, cmd in commands: + help = cmd.get_short_help_str(limit) + rows.append((subcommand, help)) + + if rows: + with formatter.section(_("Commands")): + formatter.write_dl(rows) + + def parse_args(self, ctx: Context, args: t.List[str]) -> t.List[str]: + if not args and self.no_args_is_help and not ctx.resilient_parsing: + echo(ctx.get_help(), color=ctx.color) + ctx.exit() + + rest = super().parse_args(ctx, args) + + if self.chain: + ctx.protected_args = rest + ctx.args = [] + elif rest: + ctx.protected_args, ctx.args = rest[:1], rest[1:] + + return ctx.args + + def invoke(self, ctx: Context) -> t.Any: + def _process_result(value: t.Any) -> t.Any: + if self._result_callback is not None: + value = ctx.invoke(self._result_callback, value, **ctx.params) + return value + + if not ctx.protected_args: + if self.invoke_without_command: + # No subcommand was invoked, so the result callback is + # invoked with the group return value for regular + # groups, or an empty list for chained groups. + with ctx: + rv = super().invoke(ctx) + return _process_result([] if self.chain else rv) + ctx.fail(_("Missing command.")) + + # Fetch args back out + args = [*ctx.protected_args, *ctx.args] + ctx.args = [] + ctx.protected_args = [] + + # If we're not in chain mode, we only allow the invocation of a + # single command but we also inform the current context about the + # name of the command to invoke. + if not self.chain: + # Make sure the context is entered so we do not clean up + # resources until the result processor has worked. + with ctx: + cmd_name, cmd, args = self.resolve_command(ctx, args) + assert cmd is not None + ctx.invoked_subcommand = cmd_name + super().invoke(ctx) + sub_ctx = cmd.make_context(cmd_name, args, parent=ctx) + with sub_ctx: + return _process_result(sub_ctx.command.invoke(sub_ctx)) + + # In chain mode we create the contexts step by step, but after the + # base command has been invoked. Because at that point we do not + # know the subcommands yet, the invoked subcommand attribute is + # set to ``*`` to inform the command that subcommands are executed + # but nothing else. + with ctx: + ctx.invoked_subcommand = "*" if args else None + super().invoke(ctx) + + # Otherwise we make every single context and invoke them in a + # chain. In that case the return value to the result processor + # is the list of all invoked subcommand's results. + contexts = [] + while args: + cmd_name, cmd, args = self.resolve_command(ctx, args) + assert cmd is not None + sub_ctx = cmd.make_context( + cmd_name, + args, + parent=ctx, + allow_extra_args=True, + allow_interspersed_args=False, + ) + contexts.append(sub_ctx) + args, sub_ctx.args = sub_ctx.args, [] + + rv = [] + for sub_ctx in contexts: + with sub_ctx: + rv.append(sub_ctx.command.invoke(sub_ctx)) + return _process_result(rv) + + def resolve_command( + self, ctx: Context, args: t.List[str] + ) -> t.Tuple[t.Optional[str], t.Optional[Command], t.List[str]]: + cmd_name = make_str(args[0]) + original_cmd_name = cmd_name + + # Get the command + cmd = self.get_command(ctx, cmd_name) + + # If we can't find the command but there is a normalization + # function available, we try with that one. + if cmd is None and ctx.token_normalize_func is not None: + cmd_name = ctx.token_normalize_func(cmd_name) + cmd = self.get_command(ctx, cmd_name) + + # If we don't find the command we want to show an error message + # to the user that it was not provided. However, there is + # something else we should do: if the first argument looks like + # an option we want to kick off parsing again for arguments to + # resolve things like --help which now should go to the main + # place. + if cmd is None and not ctx.resilient_parsing: + if split_opt(cmd_name)[0]: + self.parse_args(ctx, ctx.args) + ctx.fail(_("No such command {name!r}.").format(name=original_cmd_name)) + return cmd_name if cmd else None, cmd, args[1:] + + def get_command(self, ctx: Context, cmd_name: str) -> t.Optional[Command]: + """Given a context and a command name, this returns a + :class:`Command` object if it exists or returns `None`. + """ + raise NotImplementedError + + def list_commands(self, ctx: Context) -> t.List[str]: + """Returns a list of subcommand names in the order they should + appear. + """ + return [] + + def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]: + """Return a list of completions for the incomplete value. Looks + at the names of options, subcommands, and chained + multi-commands. + + :param ctx: Invocation context for this command. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + from click.shell_completion import CompletionItem + + results = [ + CompletionItem(name, help=command.get_short_help_str()) + for name, command in _complete_visible_commands(ctx, incomplete) + ] + results.extend(super().shell_complete(ctx, incomplete)) + return results + + +class Group(MultiCommand): + """A group allows a command to have subcommands attached. This is + the most common way to implement nesting in Click. + + :param name: The name of the group command. + :param commands: A dict mapping names to :class:`Command` objects. + Can also be a list of :class:`Command`, which will use + :attr:`Command.name` to create the dict. + :param attrs: Other command arguments described in + :class:`MultiCommand`, :class:`Command`, and + :class:`BaseCommand`. + + .. versionchanged:: 8.0 + The ``commands`` argument can be a list of command objects. + """ + + #: If set, this is used by the group's :meth:`command` decorator + #: as the default :class:`Command` class. This is useful to make all + #: subcommands use a custom command class. + #: + #: .. versionadded:: 8.0 + command_class: t.Optional[t.Type[Command]] = None + + #: If set, this is used by the group's :meth:`group` decorator + #: as the default :class:`Group` class. This is useful to make all + #: subgroups use a custom group class. + #: + #: If set to the special value :class:`type` (literally + #: ``group_class = type``), this group's class will be used as the + #: default class. This makes a custom group class continue to make + #: custom groups. + #: + #: .. versionadded:: 8.0 + group_class: t.Optional[t.Union[t.Type["Group"], t.Type[type]]] = None + # Literal[type] isn't valid, so use Type[type] + + def __init__( + self, + name: t.Optional[str] = None, + commands: t.Optional[ + t.Union[t.MutableMapping[str, Command], t.Sequence[Command]] + ] = None, + **attrs: t.Any, + ) -> None: + super().__init__(name, **attrs) + + if commands is None: + commands = {} + elif isinstance(commands, abc.Sequence): + commands = {c.name: c for c in commands if c.name is not None} + + #: The registered subcommands by their exported names. + self.commands: t.MutableMapping[str, Command] = commands + + def add_command(self, cmd: Command, name: t.Optional[str] = None) -> None: + """Registers another :class:`Command` with this group. If the name + is not provided, the name of the command is used. + """ + name = name or cmd.name + if name is None: + raise TypeError("Command has no name.") + _check_multicommand(self, name, cmd, register=True) + self.commands[name] = cmd + + @t.overload + def command(self, __func: t.Callable[..., t.Any]) -> Command: ... + + @t.overload + def command( + self, *args: t.Any, **kwargs: t.Any + ) -> t.Callable[[t.Callable[..., t.Any]], Command]: ... + + def command( + self, *args: t.Any, **kwargs: t.Any + ) -> t.Union[t.Callable[[t.Callable[..., t.Any]], Command], Command]: + """A shortcut decorator for declaring and attaching a command to + the group. This takes the same arguments as :func:`command` and + immediately registers the created command with this group by + calling :meth:`add_command`. + + To customize the command class used, set the + :attr:`command_class` attribute. + + .. versionchanged:: 8.1 + This decorator can be applied without parentheses. + + .. versionchanged:: 8.0 + Added the :attr:`command_class` attribute. + """ + from .decorators import command + + func: t.Optional[t.Callable[..., t.Any]] = None + + if args and callable(args[0]): + assert ( + len(args) == 1 and not kwargs + ), "Use 'command(**kwargs)(callable)' to provide arguments." + (func,) = args + args = () + + if self.command_class and kwargs.get("cls") is None: + kwargs["cls"] = self.command_class + + def decorator(f: t.Callable[..., t.Any]) -> Command: + cmd: Command = command(*args, **kwargs)(f) + self.add_command(cmd) + return cmd + + if func is not None: + return decorator(func) + + return decorator + + @t.overload + def group(self, __func: t.Callable[..., t.Any]) -> "Group": ... + + @t.overload + def group( + self, *args: t.Any, **kwargs: t.Any + ) -> t.Callable[[t.Callable[..., t.Any]], "Group"]: ... + + def group( + self, *args: t.Any, **kwargs: t.Any + ) -> t.Union[t.Callable[[t.Callable[..., t.Any]], "Group"], "Group"]: + """A shortcut decorator for declaring and attaching a group to + the group. This takes the same arguments as :func:`group` and + immediately registers the created group with this group by + calling :meth:`add_command`. + + To customize the group class used, set the :attr:`group_class` + attribute. + + .. versionchanged:: 8.1 + This decorator can be applied without parentheses. + + .. versionchanged:: 8.0 + Added the :attr:`group_class` attribute. + """ + from .decorators import group + + func: t.Optional[t.Callable[..., t.Any]] = None + + if args and callable(args[0]): + assert ( + len(args) == 1 and not kwargs + ), "Use 'group(**kwargs)(callable)' to provide arguments." + (func,) = args + args = () + + if self.group_class is not None and kwargs.get("cls") is None: + if self.group_class is type: + kwargs["cls"] = type(self) + else: + kwargs["cls"] = self.group_class + + def decorator(f: t.Callable[..., t.Any]) -> "Group": + cmd: Group = group(*args, **kwargs)(f) + self.add_command(cmd) + return cmd + + if func is not None: + return decorator(func) + + return decorator + + def get_command(self, ctx: Context, cmd_name: str) -> t.Optional[Command]: + return self.commands.get(cmd_name) + + def list_commands(self, ctx: Context) -> t.List[str]: + return sorted(self.commands) + + +class CommandCollection(MultiCommand): + """A command collection is a multi command that merges multiple multi + commands together into one. This is a straightforward implementation + that accepts a list of different multi commands as sources and + provides all the commands for each of them. + + See :class:`MultiCommand` and :class:`Command` for the description of + ``name`` and ``attrs``. + """ + + def __init__( + self, + name: t.Optional[str] = None, + sources: t.Optional[t.List[MultiCommand]] = None, + **attrs: t.Any, + ) -> None: + super().__init__(name, **attrs) + #: The list of registered multi commands. + self.sources: t.List[MultiCommand] = sources or [] + + def add_source(self, multi_cmd: MultiCommand) -> None: + """Adds a new multi command to the chain dispatcher.""" + self.sources.append(multi_cmd) + + def get_command(self, ctx: Context, cmd_name: str) -> t.Optional[Command]: + for source in self.sources: + rv = source.get_command(ctx, cmd_name) + + if rv is not None: + if self.chain: + _check_multicommand(self, cmd_name, rv) + + return rv + + return None + + def list_commands(self, ctx: Context) -> t.List[str]: + rv: t.Set[str] = set() + + for source in self.sources: + rv.update(source.list_commands(ctx)) + + return sorted(rv) + + +def _check_iter(value: t.Any) -> t.Iterator[t.Any]: + """Check if the value is iterable but not a string. Raises a type + error, or return an iterator over the value. + """ + if isinstance(value, str): + raise TypeError + + return iter(value) + + +class Parameter: + r"""A parameter to a command comes in two versions: they are either + :class:`Option`\s or :class:`Argument`\s. Other subclasses are currently + not supported by design as some of the internals for parsing are + intentionally not finalized. + + Some settings are supported by both options and arguments. + + :param param_decls: the parameter declarations for this option or + argument. This is a list of flags or argument + names. + :param type: the type that should be used. Either a :class:`ParamType` + or a Python type. The latter is converted into the former + automatically if supported. + :param required: controls if this is optional or not. + :param default: the default value if omitted. This can also be a callable, + in which case it's invoked when the default is needed + without any arguments. + :param callback: A function to further process or validate the value + after type conversion. It is called as ``f(ctx, param, value)`` + and must return the value. It is called for all sources, + including prompts. + :param nargs: the number of arguments to match. If not ``1`` the return + value is a tuple instead of single value. The default for + nargs is ``1`` (except if the type is a tuple, then it's + the arity of the tuple). If ``nargs=-1``, all remaining + parameters are collected. + :param metavar: how the value is represented in the help page. + :param expose_value: if this is `True` then the value is passed onwards + to the command callback and stored on the context, + otherwise it's skipped. + :param is_eager: eager values are processed before non eager ones. This + should not be set for arguments or it will inverse the + order of processing. + :param envvar: a string or list of strings that are environment variables + that should be checked. + :param shell_complete: A function that returns custom shell + completions. Used instead of the param's type completion if + given. Takes ``ctx, param, incomplete`` and must return a list + of :class:`~click.shell_completion.CompletionItem` or a list of + strings. + + .. versionchanged:: 8.0 + ``process_value`` validates required parameters and bounded + ``nargs``, and invokes the parameter callback before returning + the value. This allows the callback to validate prompts. + ``full_process_value`` is removed. + + .. versionchanged:: 8.0 + ``autocompletion`` is renamed to ``shell_complete`` and has new + semantics described above. The old name is deprecated and will + be removed in 8.1, until then it will be wrapped to match the + new requirements. + + .. versionchanged:: 8.0 + For ``multiple=True, nargs>1``, the default must be a list of + tuples. + + .. versionchanged:: 8.0 + Setting a default is no longer required for ``nargs>1``, it will + default to ``None``. ``multiple=True`` or ``nargs=-1`` will + default to ``()``. + + .. versionchanged:: 7.1 + Empty environment variables are ignored rather than taking the + empty string value. This makes it possible for scripts to clear + variables if they can't unset them. + + .. versionchanged:: 2.0 + Changed signature for parameter callback to also be passed the + parameter. The old callback format will still work, but it will + raise a warning to give you a chance to migrate the code easier. + """ + + param_type_name = "parameter" + + def __init__( + self, + param_decls: t.Optional[t.Sequence[str]] = None, + type: t.Optional[t.Union[types.ParamType, t.Any]] = None, + required: bool = False, + default: t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]] = None, + callback: t.Optional[t.Callable[[Context, "Parameter", t.Any], t.Any]] = None, + nargs: t.Optional[int] = None, + multiple: bool = False, + metavar: t.Optional[str] = None, + expose_value: bool = True, + is_eager: bool = False, + envvar: t.Optional[t.Union[str, t.Sequence[str]]] = None, + shell_complete: t.Optional[ + t.Callable[ + [Context, "Parameter", str], + t.Union[t.List["CompletionItem"], t.List[str]], + ] + ] = None, + ) -> None: + self.name: t.Optional[str] + self.opts: t.List[str] + self.secondary_opts: t.List[str] + self.name, self.opts, self.secondary_opts = self._parse_decls( + param_decls or (), expose_value + ) + self.type: types.ParamType = types.convert_type(type, default) + + # Default nargs to what the type tells us if we have that + # information available. + if nargs is None: + if self.type.is_composite: + nargs = self.type.arity + else: + nargs = 1 + + self.required = required + self.callback = callback + self.nargs = nargs + self.multiple = multiple + self.expose_value = expose_value + self.default = default + self.is_eager = is_eager + self.metavar = metavar + self.envvar = envvar + self._custom_shell_complete = shell_complete + + if __debug__: + if self.type.is_composite and nargs != self.type.arity: + raise ValueError( + f"'nargs' must be {self.type.arity} (or None) for" + f" type {self.type!r}, but it was {nargs}." + ) + + # Skip no default or callable default. + check_default = default if not callable(default) else None + + if check_default is not None: + if multiple: + try: + # Only check the first value against nargs. + check_default = next(_check_iter(check_default), None) + except TypeError: + raise ValueError( + "'default' must be a list when 'multiple' is true." + ) from None + + # Can be None for multiple with empty default. + if nargs != 1 and check_default is not None: + try: + _check_iter(check_default) + except TypeError: + if multiple: + message = ( + "'default' must be a list of lists when 'multiple' is" + " true and 'nargs' != 1." + ) + else: + message = "'default' must be a list when 'nargs' != 1." + + raise ValueError(message) from None + + if nargs > 1 and len(check_default) != nargs: + subject = "item length" if multiple else "length" + raise ValueError( + f"'default' {subject} must match nargs={nargs}." + ) + + def to_info_dict(self) -> t.Dict[str, t.Any]: + """Gather information that could be useful for a tool generating + user-facing documentation. + + Use :meth:`click.Context.to_info_dict` to traverse the entire + CLI structure. + + .. versionadded:: 8.0 + """ + return { + "name": self.name, + "param_type_name": self.param_type_name, + "opts": self.opts, + "secondary_opts": self.secondary_opts, + "type": self.type.to_info_dict(), + "required": self.required, + "nargs": self.nargs, + "multiple": self.multiple, + "default": self.default, + "envvar": self.envvar, + } + + def __repr__(self) -> str: + return f"<{self.__class__.__name__} {self.name}>" + + def _parse_decls( + self, decls: t.Sequence[str], expose_value: bool + ) -> t.Tuple[t.Optional[str], t.List[str], t.List[str]]: + raise NotImplementedError() + + @property + def human_readable_name(self) -> str: + """Returns the human readable name of this parameter. This is the + same as the name for options, but the metavar for arguments. + """ + return self.name # type: ignore + + def make_metavar(self) -> str: + if self.metavar is not None: + return self.metavar + + metavar = self.type.get_metavar(self) + + if metavar is None: + metavar = self.type.name.upper() + + if self.nargs != 1: + metavar += "..." + + return metavar + + @t.overload + def get_default( + self, ctx: Context, call: "te.Literal[True]" = True + ) -> t.Optional[t.Any]: ... + + @t.overload + def get_default( + self, ctx: Context, call: bool = ... + ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]: ... + + def get_default( + self, ctx: Context, call: bool = True + ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]: + """Get the default for the parameter. Tries + :meth:`Context.lookup_default` first, then the local default. + + :param ctx: Current context. + :param call: If the default is a callable, call it. Disable to + return the callable instead. + + .. versionchanged:: 8.0.2 + Type casting is no longer performed when getting a default. + + .. versionchanged:: 8.0.1 + Type casting can fail in resilient parsing mode. Invalid + defaults will not prevent showing help text. + + .. versionchanged:: 8.0 + Looks at ``ctx.default_map`` first. + + .. versionchanged:: 8.0 + Added the ``call`` parameter. + """ + value = ctx.lookup_default(self.name, call=False) # type: ignore + + if value is None: + value = self.default + + if call and callable(value): + value = value() + + return value + + def add_to_parser(self, parser: OptionParser, ctx: Context) -> None: + raise NotImplementedError() + + def consume_value( + self, ctx: Context, opts: t.Mapping[str, t.Any] + ) -> t.Tuple[t.Any, ParameterSource]: + value = opts.get(self.name) # type: ignore + source = ParameterSource.COMMANDLINE + + if value is None: + value = self.value_from_envvar(ctx) + source = ParameterSource.ENVIRONMENT + + if value is None: + value = ctx.lookup_default(self.name) # type: ignore + source = ParameterSource.DEFAULT_MAP + + if value is None: + value = self.get_default(ctx) + source = ParameterSource.DEFAULT + + return value, source + + def type_cast_value(self, ctx: Context, value: t.Any) -> t.Any: + """Convert and validate a value against the option's + :attr:`type`, :attr:`multiple`, and :attr:`nargs`. + """ + if value is None: + return () if self.multiple or self.nargs == -1 else None + + def check_iter(value: t.Any) -> t.Iterator[t.Any]: + try: + return _check_iter(value) + except TypeError: + # This should only happen when passing in args manually, + # the parser should construct an iterable when parsing + # the command line. + raise BadParameter( + _("Value must be an iterable."), ctx=ctx, param=self + ) from None + + if self.nargs == 1 or self.type.is_composite: + + def convert(value: t.Any) -> t.Any: + return self.type(value, param=self, ctx=ctx) + + elif self.nargs == -1: + + def convert(value: t.Any) -> t.Any: # t.Tuple[t.Any, ...] + return tuple(self.type(x, self, ctx) for x in check_iter(value)) + + else: # nargs > 1 + + def convert(value: t.Any) -> t.Any: # t.Tuple[t.Any, ...] + value = tuple(check_iter(value)) + + if len(value) != self.nargs: + raise BadParameter( + ngettext( + "Takes {nargs} values but 1 was given.", + "Takes {nargs} values but {len} were given.", + len(value), + ).format(nargs=self.nargs, len=len(value)), + ctx=ctx, + param=self, + ) + + return tuple(self.type(x, self, ctx) for x in value) + + if self.multiple: + return tuple(convert(x) for x in check_iter(value)) + + return convert(value) + + def value_is_missing(self, value: t.Any) -> bool: + if value is None: + return True + + if (self.nargs != 1 or self.multiple) and value == (): + return True + + return False + + def process_value(self, ctx: Context, value: t.Any) -> t.Any: + value = self.type_cast_value(ctx, value) + + if self.required and self.value_is_missing(value): + raise MissingParameter(ctx=ctx, param=self) + + if self.callback is not None: + value = self.callback(ctx, self, value) + + return value + + def resolve_envvar_value(self, ctx: Context) -> t.Optional[str]: + if self.envvar is None: + return None + + if isinstance(self.envvar, str): + rv = os.environ.get(self.envvar) + + if rv: + return rv + else: + for envvar in self.envvar: + rv = os.environ.get(envvar) + + if rv: + return rv + + return None + + def value_from_envvar(self, ctx: Context) -> t.Optional[t.Any]: + rv: t.Optional[t.Any] = self.resolve_envvar_value(ctx) + + if rv is not None and self.nargs != 1: + rv = self.type.split_envvar_value(rv) + + return rv + + def handle_parse_result( + self, ctx: Context, opts: t.Mapping[str, t.Any], args: t.List[str] + ) -> t.Tuple[t.Any, t.List[str]]: + with augment_usage_errors(ctx, param=self): + value, source = self.consume_value(ctx, opts) + ctx.set_parameter_source(self.name, source) # type: ignore + + try: + value = self.process_value(ctx, value) + except Exception: + if not ctx.resilient_parsing: + raise + + value = None + + if self.expose_value: + ctx.params[self.name] = value # type: ignore + + return value, args + + def get_help_record(self, ctx: Context) -> t.Optional[t.Tuple[str, str]]: + pass + + def get_usage_pieces(self, ctx: Context) -> t.List[str]: + return [] + + def get_error_hint(self, ctx: Context) -> str: + """Get a stringified version of the param for use in error messages to + indicate which param caused the error. + """ + hint_list = self.opts or [self.human_readable_name] + return " / ".join(f"'{x}'" for x in hint_list) + + def shell_complete(self, ctx: Context, incomplete: str) -> t.List["CompletionItem"]: + """Return a list of completions for the incomplete value. If a + ``shell_complete`` function was given during init, it is used. + Otherwise, the :attr:`type` + :meth:`~click.types.ParamType.shell_complete` function is used. + + :param ctx: Invocation context for this command. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + if self._custom_shell_complete is not None: + results = self._custom_shell_complete(ctx, self, incomplete) + + if results and isinstance(results[0], str): + from click.shell_completion import CompletionItem + + results = [CompletionItem(c) for c in results] + + return t.cast(t.List["CompletionItem"], results) + + return self.type.shell_complete(ctx, self, incomplete) + + +class Option(Parameter): + """Options are usually optional values on the command line and + have some extra features that arguments don't have. + + All other parameters are passed onwards to the parameter constructor. + + :param show_default: Show the default value for this option in its + help text. Values are not shown by default, unless + :attr:`Context.show_default` is ``True``. If this value is a + string, it shows that string in parentheses instead of the + actual value. This is particularly useful for dynamic options. + For single option boolean flags, the default remains hidden if + its value is ``False``. + :param show_envvar: Controls if an environment variable should be + shown on the help page. Normally, environment variables are not + shown. + :param prompt: If set to ``True`` or a non empty string then the + user will be prompted for input. If set to ``True`` the prompt + will be the option name capitalized. + :param confirmation_prompt: Prompt a second time to confirm the + value if it was prompted for. Can be set to a string instead of + ``True`` to customize the message. + :param prompt_required: If set to ``False``, the user will be + prompted for input only when the option was specified as a flag + without a value. + :param hide_input: If this is ``True`` then the input on the prompt + will be hidden from the user. This is useful for password input. + :param is_flag: forces this option to act as a flag. The default is + auto detection. + :param flag_value: which value should be used for this flag if it's + enabled. This is set to a boolean automatically if + the option string contains a slash to mark two options. + :param multiple: if this is set to `True` then the argument is accepted + multiple times and recorded. This is similar to ``nargs`` + in how it works but supports arbitrary number of + arguments. + :param count: this flag makes an option increment an integer. + :param allow_from_autoenv: if this is enabled then the value of this + parameter will be pulled from an environment + variable in case a prefix is defined on the + context. + :param help: the help string. + :param hidden: hide this option from help outputs. + :param attrs: Other command arguments described in :class:`Parameter`. + + .. versionchanged:: 8.1.0 + Help text indentation is cleaned here instead of only in the + ``@option`` decorator. + + .. versionchanged:: 8.1.0 + The ``show_default`` parameter overrides + ``Context.show_default``. + + .. versionchanged:: 8.1.0 + The default of a single option boolean flag is not shown if the + default value is ``False``. + + .. versionchanged:: 8.0.1 + ``type`` is detected from ``flag_value`` if given. + """ + + param_type_name = "option" + + def __init__( + self, + param_decls: t.Optional[t.Sequence[str]] = None, + show_default: t.Union[bool, str, None] = None, + prompt: t.Union[bool, str] = False, + confirmation_prompt: t.Union[bool, str] = False, + prompt_required: bool = True, + hide_input: bool = False, + is_flag: t.Optional[bool] = None, + flag_value: t.Optional[t.Any] = None, + multiple: bool = False, + count: bool = False, + allow_from_autoenv: bool = True, + type: t.Optional[t.Union[types.ParamType, t.Any]] = None, + help: t.Optional[str] = None, + hidden: bool = False, + show_choices: bool = True, + show_envvar: bool = False, + **attrs: t.Any, + ) -> None: + if help: + help = inspect.cleandoc(help) + + default_is_missing = "default" not in attrs + super().__init__(param_decls, type=type, multiple=multiple, **attrs) + + if prompt is True: + if self.name is None: + raise TypeError("'name' is required with 'prompt=True'.") + + prompt_text: t.Optional[str] = self.name.replace("_", " ").capitalize() + elif prompt is False: + prompt_text = None + else: + prompt_text = prompt + + self.prompt = prompt_text + self.confirmation_prompt = confirmation_prompt + self.prompt_required = prompt_required + self.hide_input = hide_input + self.hidden = hidden + + # If prompt is enabled but not required, then the option can be + # used as a flag to indicate using prompt or flag_value. + self._flag_needs_value = self.prompt is not None and not self.prompt_required + + if is_flag is None: + if flag_value is not None: + # Implicitly a flag because flag_value was set. + is_flag = True + elif self._flag_needs_value: + # Not a flag, but when used as a flag it shows a prompt. + is_flag = False + else: + # Implicitly a flag because flag options were given. + is_flag = bool(self.secondary_opts) + elif is_flag is False and not self._flag_needs_value: + # Not a flag, and prompt is not enabled, can be used as a + # flag if flag_value is set. + self._flag_needs_value = flag_value is not None + + self.default: t.Union[t.Any, t.Callable[[], t.Any]] + + if is_flag and default_is_missing and not self.required: + if multiple: + self.default = () + else: + self.default = False + + if flag_value is None: + flag_value = not self.default + + self.type: types.ParamType + if is_flag and type is None: + # Re-guess the type from the flag value instead of the + # default. + self.type = types.convert_type(None, flag_value) + + self.is_flag: bool = is_flag + self.is_bool_flag: bool = is_flag and isinstance(self.type, types.BoolParamType) + self.flag_value: t.Any = flag_value + + # Counting + self.count = count + if count: + if type is None: + self.type = types.IntRange(min=0) + if default_is_missing: + self.default = 0 + + self.allow_from_autoenv = allow_from_autoenv + self.help = help + self.show_default = show_default + self.show_choices = show_choices + self.show_envvar = show_envvar + + if __debug__: + if self.nargs == -1: + raise TypeError("nargs=-1 is not supported for options.") + + if self.prompt and self.is_flag and not self.is_bool_flag: + raise TypeError("'prompt' is not valid for non-boolean flag.") + + if not self.is_bool_flag and self.secondary_opts: + raise TypeError("Secondary flag is not valid for non-boolean flag.") + + if self.is_bool_flag and self.hide_input and self.prompt is not None: + raise TypeError( + "'prompt' with 'hide_input' is not valid for boolean flag." + ) + + if self.count: + if self.multiple: + raise TypeError("'count' is not valid with 'multiple'.") + + if self.is_flag: + raise TypeError("'count' is not valid with 'is_flag'.") + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict.update( + help=self.help, + prompt=self.prompt, + is_flag=self.is_flag, + flag_value=self.flag_value, + count=self.count, + hidden=self.hidden, + ) + return info_dict + + def _parse_decls( + self, decls: t.Sequence[str], expose_value: bool + ) -> t.Tuple[t.Optional[str], t.List[str], t.List[str]]: + opts = [] + secondary_opts = [] + name = None + possible_names = [] + + for decl in decls: + if decl.isidentifier(): + if name is not None: + raise TypeError(f"Name '{name}' defined twice") + name = decl + else: + split_char = ";" if decl[:1] == "/" else "/" + if split_char in decl: + first, second = decl.split(split_char, 1) + first = first.rstrip() + if first: + possible_names.append(split_opt(first)) + opts.append(first) + second = second.lstrip() + if second: + secondary_opts.append(second.lstrip()) + if first == second: + raise ValueError( + f"Boolean option {decl!r} cannot use the" + " same flag for true/false." + ) + else: + possible_names.append(split_opt(decl)) + opts.append(decl) + + if name is None and possible_names: + possible_names.sort(key=lambda x: -len(x[0])) # group long options first + name = possible_names[0][1].replace("-", "_").lower() + if not name.isidentifier(): + name = None + + if name is None: + if not expose_value: + return None, opts, secondary_opts + raise TypeError( + f"Could not determine name for option with declarations {decls!r}" + ) + + if not opts and not secondary_opts: + raise TypeError( + f"No options defined but a name was passed ({name})." + " Did you mean to declare an argument instead? Did" + f" you mean to pass '--{name}'?" + ) + + return name, opts, secondary_opts + + def add_to_parser(self, parser: OptionParser, ctx: Context) -> None: + if self.multiple: + action = "append" + elif self.count: + action = "count" + else: + action = "store" + + if self.is_flag: + action = f"{action}_const" + + if self.is_bool_flag and self.secondary_opts: + parser.add_option( + obj=self, opts=self.opts, dest=self.name, action=action, const=True + ) + parser.add_option( + obj=self, + opts=self.secondary_opts, + dest=self.name, + action=action, + const=False, + ) + else: + parser.add_option( + obj=self, + opts=self.opts, + dest=self.name, + action=action, + const=self.flag_value, + ) + else: + parser.add_option( + obj=self, + opts=self.opts, + dest=self.name, + action=action, + nargs=self.nargs, + ) + + def get_help_record(self, ctx: Context) -> t.Optional[t.Tuple[str, str]]: + if self.hidden: + return None + + any_prefix_is_slash = False + + def _write_opts(opts: t.Sequence[str]) -> str: + nonlocal any_prefix_is_slash + + rv, any_slashes = join_options(opts) + + if any_slashes: + any_prefix_is_slash = True + + if not self.is_flag and not self.count: + rv += f" {self.make_metavar()}" + + return rv + + rv = [_write_opts(self.opts)] + + if self.secondary_opts: + rv.append(_write_opts(self.secondary_opts)) + + help = self.help or "" + extra = [] + + if self.show_envvar: + envvar = self.envvar + + if envvar is None: + if ( + self.allow_from_autoenv + and ctx.auto_envvar_prefix is not None + and self.name is not None + ): + envvar = f"{ctx.auto_envvar_prefix}_{self.name.upper()}" + + if envvar is not None: + var_str = ( + envvar + if isinstance(envvar, str) + else ", ".join(str(d) for d in envvar) + ) + extra.append(_("env var: {var}").format(var=var_str)) + + # Temporarily enable resilient parsing to avoid type casting + # failing for the default. Might be possible to extend this to + # help formatting in general. + resilient = ctx.resilient_parsing + ctx.resilient_parsing = True + + try: + default_value = self.get_default(ctx, call=False) + finally: + ctx.resilient_parsing = resilient + + show_default = False + show_default_is_str = False + + if self.show_default is not None: + if isinstance(self.show_default, str): + show_default_is_str = show_default = True + else: + show_default = self.show_default + elif ctx.show_default is not None: + show_default = ctx.show_default + + if show_default_is_str or (show_default and (default_value is not None)): + if show_default_is_str: + default_string = f"({self.show_default})" + elif isinstance(default_value, (list, tuple)): + default_string = ", ".join(str(d) for d in default_value) + elif inspect.isfunction(default_value): + default_string = _("(dynamic)") + elif self.is_bool_flag and self.secondary_opts: + # For boolean flags that have distinct True/False opts, + # use the opt without prefix instead of the value. + default_string = split_opt( + (self.opts if default_value else self.secondary_opts)[0] + )[1] + elif self.is_bool_flag and not self.secondary_opts and not default_value: + default_string = "" + elif default_value == "": + default_string = '""' + else: + default_string = str(default_value) + + if default_string: + extra.append(_("default: {default}").format(default=default_string)) + + if ( + isinstance(self.type, types._NumberRangeBase) + # skip count with default range type + and not (self.count and self.type.min == 0 and self.type.max is None) + ): + range_str = self.type._describe_range() + + if range_str: + extra.append(range_str) + + if self.required: + extra.append(_("required")) + + if extra: + extra_str = "; ".join(extra) + help = f"{help} [{extra_str}]" if help else f"[{extra_str}]" + + return ("; " if any_prefix_is_slash else " / ").join(rv), help + + @t.overload + def get_default( + self, ctx: Context, call: "te.Literal[True]" = True + ) -> t.Optional[t.Any]: ... + + @t.overload + def get_default( + self, ctx: Context, call: bool = ... + ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]: ... + + def get_default( + self, ctx: Context, call: bool = True + ) -> t.Optional[t.Union[t.Any, t.Callable[[], t.Any]]]: + # If we're a non boolean flag our default is more complex because + # we need to look at all flags in the same group to figure out + # if we're the default one in which case we return the flag + # value as default. + if self.is_flag and not self.is_bool_flag: + for param in ctx.command.params: + if param.name == self.name and param.default: + return t.cast(Option, param).flag_value + + return None + + return super().get_default(ctx, call=call) + + def prompt_for_value(self, ctx: Context) -> t.Any: + """This is an alternative flow that can be activated in the full + value processing if a value does not exist. It will prompt the + user until a valid value exists and then returns the processed + value as result. + """ + assert self.prompt is not None + + # Calculate the default before prompting anything to be stable. + default = self.get_default(ctx) + + # If this is a prompt for a flag we need to handle this + # differently. + if self.is_bool_flag: + return confirm(self.prompt, default) + + return prompt( + self.prompt, + default=default, + type=self.type, + hide_input=self.hide_input, + show_choices=self.show_choices, + confirmation_prompt=self.confirmation_prompt, + value_proc=lambda x: self.process_value(ctx, x), + ) + + def resolve_envvar_value(self, ctx: Context) -> t.Optional[str]: + rv = super().resolve_envvar_value(ctx) + + if rv is not None: + return rv + + if ( + self.allow_from_autoenv + and ctx.auto_envvar_prefix is not None + and self.name is not None + ): + envvar = f"{ctx.auto_envvar_prefix}_{self.name.upper()}" + rv = os.environ.get(envvar) + + if rv: + return rv + + return None + + def value_from_envvar(self, ctx: Context) -> t.Optional[t.Any]: + rv: t.Optional[t.Any] = self.resolve_envvar_value(ctx) + + if rv is None: + return None + + value_depth = (self.nargs != 1) + bool(self.multiple) + + if value_depth > 0: + rv = self.type.split_envvar_value(rv) + + if self.multiple and self.nargs != 1: + rv = batch(rv, self.nargs) + + return rv + + def consume_value( + self, ctx: Context, opts: t.Mapping[str, "Parameter"] + ) -> t.Tuple[t.Any, ParameterSource]: + value, source = super().consume_value(ctx, opts) + + # The parser will emit a sentinel value if the option can be + # given as a flag without a value. This is different from None + # to distinguish from the flag not being given at all. + if value is _flag_needs_value: + if self.prompt is not None and not ctx.resilient_parsing: + value = self.prompt_for_value(ctx) + source = ParameterSource.PROMPT + else: + value = self.flag_value + source = ParameterSource.COMMANDLINE + + elif ( + self.multiple + and value is not None + and any(v is _flag_needs_value for v in value) + ): + value = [self.flag_value if v is _flag_needs_value else v for v in value] + source = ParameterSource.COMMANDLINE + + # The value wasn't set, or used the param's default, prompt if + # prompting is enabled. + elif ( + source in {None, ParameterSource.DEFAULT} + and self.prompt is not None + and (self.required or self.prompt_required) + and not ctx.resilient_parsing + ): + value = self.prompt_for_value(ctx) + source = ParameterSource.PROMPT + + return value, source + + +class Argument(Parameter): + """Arguments are positional parameters to a command. They generally + provide fewer features than options but can have infinite ``nargs`` + and are required by default. + + All parameters are passed onwards to the constructor of :class:`Parameter`. + """ + + param_type_name = "argument" + + def __init__( + self, + param_decls: t.Sequence[str], + required: t.Optional[bool] = None, + **attrs: t.Any, + ) -> None: + if required is None: + if attrs.get("default") is not None: + required = False + else: + required = attrs.get("nargs", 1) > 0 + + if "multiple" in attrs: + raise TypeError("__init__() got an unexpected keyword argument 'multiple'.") + + super().__init__(param_decls, required=required, **attrs) + + if __debug__: + if self.default is not None and self.nargs == -1: + raise TypeError("'default' is not supported for nargs=-1.") + + @property + def human_readable_name(self) -> str: + if self.metavar is not None: + return self.metavar + return self.name.upper() # type: ignore + + def make_metavar(self) -> str: + if self.metavar is not None: + return self.metavar + var = self.type.get_metavar(self) + if not var: + var = self.name.upper() # type: ignore + if not self.required: + var = f"[{var}]" + if self.nargs != 1: + var += "..." + return var + + def _parse_decls( + self, decls: t.Sequence[str], expose_value: bool + ) -> t.Tuple[t.Optional[str], t.List[str], t.List[str]]: + if not decls: + if not expose_value: + return None, [], [] + raise TypeError("Argument is marked as exposed, but does not have a name.") + if len(decls) == 1: + name = arg = decls[0] + name = name.replace("-", "_").lower() + else: + raise TypeError( + "Arguments take exactly one parameter declaration, got" + f" {len(decls)}." + ) + return name, [arg], [] + + def get_usage_pieces(self, ctx: Context) -> t.List[str]: + return [self.make_metavar()] + + def get_error_hint(self, ctx: Context) -> str: + return f"'{self.make_metavar()}'" + + def add_to_parser(self, parser: OptionParser, ctx: Context) -> None: + parser.add_argument(dest=self.name, nargs=self.nargs, obj=self) diff --git a/.venv/Lib/site-packages/click/decorators.py b/.venv/Lib/site-packages/click/decorators.py new file mode 100644 index 0000000..bcf8906 --- /dev/null +++ b/.venv/Lib/site-packages/click/decorators.py @@ -0,0 +1,562 @@ +import inspect +import types +import typing as t +from functools import update_wrapper +from gettext import gettext as _ + +from .core import Argument +from .core import Command +from .core import Context +from .core import Group +from .core import Option +from .core import Parameter +from .globals import get_current_context +from .utils import echo + +if t.TYPE_CHECKING: + import typing_extensions as te + + P = te.ParamSpec("P") + +R = t.TypeVar("R") +T = t.TypeVar("T") +_AnyCallable = t.Callable[..., t.Any] +FC = t.TypeVar("FC", bound=t.Union[_AnyCallable, Command]) + + +def pass_context(f: "t.Callable[te.Concatenate[Context, P], R]") -> "t.Callable[P, R]": + """Marks a callback as wanting to receive the current context + object as first argument. + """ + + def new_func(*args: "P.args", **kwargs: "P.kwargs") -> "R": + return f(get_current_context(), *args, **kwargs) + + return update_wrapper(new_func, f) + + +def pass_obj(f: "t.Callable[te.Concatenate[t.Any, P], R]") -> "t.Callable[P, R]": + """Similar to :func:`pass_context`, but only pass the object on the + context onwards (:attr:`Context.obj`). This is useful if that object + represents the state of a nested system. + """ + + def new_func(*args: "P.args", **kwargs: "P.kwargs") -> "R": + return f(get_current_context().obj, *args, **kwargs) + + return update_wrapper(new_func, f) + + +def make_pass_decorator( + object_type: t.Type[T], ensure: bool = False +) -> t.Callable[["t.Callable[te.Concatenate[T, P], R]"], "t.Callable[P, R]"]: + """Given an object type this creates a decorator that will work + similar to :func:`pass_obj` but instead of passing the object of the + current context, it will find the innermost context of type + :func:`object_type`. + + This generates a decorator that works roughly like this:: + + from functools import update_wrapper + + def decorator(f): + @pass_context + def new_func(ctx, *args, **kwargs): + obj = ctx.find_object(object_type) + return ctx.invoke(f, obj, *args, **kwargs) + return update_wrapper(new_func, f) + return decorator + + :param object_type: the type of the object to pass. + :param ensure: if set to `True`, a new object will be created and + remembered on the context if it's not there yet. + """ + + def decorator(f: "t.Callable[te.Concatenate[T, P], R]") -> "t.Callable[P, R]": + def new_func(*args: "P.args", **kwargs: "P.kwargs") -> "R": + ctx = get_current_context() + + obj: t.Optional[T] + if ensure: + obj = ctx.ensure_object(object_type) + else: + obj = ctx.find_object(object_type) + + if obj is None: + raise RuntimeError( + "Managed to invoke callback without a context" + f" object of type {object_type.__name__!r}" + " existing." + ) + + return ctx.invoke(f, obj, *args, **kwargs) + + return update_wrapper(new_func, f) + + return decorator + + +def pass_meta_key( + key: str, *, doc_description: t.Optional[str] = None +) -> "t.Callable[[t.Callable[te.Concatenate[t.Any, P], R]], t.Callable[P, R]]": + """Create a decorator that passes a key from + :attr:`click.Context.meta` as the first argument to the decorated + function. + + :param key: Key in ``Context.meta`` to pass. + :param doc_description: Description of the object being passed, + inserted into the decorator's docstring. Defaults to "the 'key' + key from Context.meta". + + .. versionadded:: 8.0 + """ + + def decorator(f: "t.Callable[te.Concatenate[t.Any, P], R]") -> "t.Callable[P, R]": + def new_func(*args: "P.args", **kwargs: "P.kwargs") -> R: + ctx = get_current_context() + obj = ctx.meta[key] + return ctx.invoke(f, obj, *args, **kwargs) + + return update_wrapper(new_func, f) + + if doc_description is None: + doc_description = f"the {key!r} key from :attr:`click.Context.meta`" + + decorator.__doc__ = ( + f"Decorator that passes {doc_description} as the first argument" + " to the decorated function." + ) + return decorator + + +CmdType = t.TypeVar("CmdType", bound=Command) + + +# variant: no call, directly as decorator for a function. +@t.overload +def command(name: _AnyCallable) -> Command: ... + + +# variant: with positional name and with positional or keyword cls argument: +# @command(namearg, CommandCls, ...) or @command(namearg, cls=CommandCls, ...) +@t.overload +def command( + name: t.Optional[str], + cls: t.Type[CmdType], + **attrs: t.Any, +) -> t.Callable[[_AnyCallable], CmdType]: ... + + +# variant: name omitted, cls _must_ be a keyword argument, @command(cls=CommandCls, ...) +@t.overload +def command( + name: None = None, + *, + cls: t.Type[CmdType], + **attrs: t.Any, +) -> t.Callable[[_AnyCallable], CmdType]: ... + + +# variant: with optional string name, no cls argument provided. +@t.overload +def command( + name: t.Optional[str] = ..., cls: None = None, **attrs: t.Any +) -> t.Callable[[_AnyCallable], Command]: ... + + +def command( + name: t.Union[t.Optional[str], _AnyCallable] = None, + cls: t.Optional[t.Type[CmdType]] = None, + **attrs: t.Any, +) -> t.Union[Command, t.Callable[[_AnyCallable], t.Union[Command, CmdType]]]: + r"""Creates a new :class:`Command` and uses the decorated function as + callback. This will also automatically attach all decorated + :func:`option`\s and :func:`argument`\s as parameters to the command. + + The name of the command defaults to the name of the function with + underscores replaced by dashes. If you want to change that, you can + pass the intended name as the first argument. + + All keyword arguments are forwarded to the underlying command class. + For the ``params`` argument, any decorated params are appended to + the end of the list. + + Once decorated the function turns into a :class:`Command` instance + that can be invoked as a command line utility or be attached to a + command :class:`Group`. + + :param name: the name of the command. This defaults to the function + name with underscores replaced by dashes. + :param cls: the command class to instantiate. This defaults to + :class:`Command`. + + .. versionchanged:: 8.1 + This decorator can be applied without parentheses. + + .. versionchanged:: 8.1 + The ``params`` argument can be used. Decorated params are + appended to the end of the list. + """ + + func: t.Optional[t.Callable[[_AnyCallable], t.Any]] = None + + if callable(name): + func = name + name = None + assert cls is None, "Use 'command(cls=cls)(callable)' to specify a class." + assert not attrs, "Use 'command(**kwargs)(callable)' to provide arguments." + + if cls is None: + cls = t.cast(t.Type[CmdType], Command) + + def decorator(f: _AnyCallable) -> CmdType: + if isinstance(f, Command): + raise TypeError("Attempted to convert a callback into a command twice.") + + attr_params = attrs.pop("params", None) + params = attr_params if attr_params is not None else [] + + try: + decorator_params = f.__click_params__ # type: ignore + except AttributeError: + pass + else: + del f.__click_params__ # type: ignore + params.extend(reversed(decorator_params)) + + if attrs.get("help") is None: + attrs["help"] = f.__doc__ + + if t.TYPE_CHECKING: + assert cls is not None + assert not callable(name) + + cmd = cls( + name=name or f.__name__.lower().replace("_", "-"), + callback=f, + params=params, + **attrs, + ) + cmd.__doc__ = f.__doc__ + return cmd + + if func is not None: + return decorator(func) + + return decorator + + +GrpType = t.TypeVar("GrpType", bound=Group) + + +# variant: no call, directly as decorator for a function. +@t.overload +def group(name: _AnyCallable) -> Group: ... + + +# variant: with positional name and with positional or keyword cls argument: +# @group(namearg, GroupCls, ...) or @group(namearg, cls=GroupCls, ...) +@t.overload +def group( + name: t.Optional[str], + cls: t.Type[GrpType], + **attrs: t.Any, +) -> t.Callable[[_AnyCallable], GrpType]: ... + + +# variant: name omitted, cls _must_ be a keyword argument, @group(cmd=GroupCls, ...) +@t.overload +def group( + name: None = None, + *, + cls: t.Type[GrpType], + **attrs: t.Any, +) -> t.Callable[[_AnyCallable], GrpType]: ... + + +# variant: with optional string name, no cls argument provided. +@t.overload +def group( + name: t.Optional[str] = ..., cls: None = None, **attrs: t.Any +) -> t.Callable[[_AnyCallable], Group]: ... + + +def group( + name: t.Union[str, _AnyCallable, None] = None, + cls: t.Optional[t.Type[GrpType]] = None, + **attrs: t.Any, +) -> t.Union[Group, t.Callable[[_AnyCallable], t.Union[Group, GrpType]]]: + """Creates a new :class:`Group` with a function as callback. This + works otherwise the same as :func:`command` just that the `cls` + parameter is set to :class:`Group`. + + .. versionchanged:: 8.1 + This decorator can be applied without parentheses. + """ + if cls is None: + cls = t.cast(t.Type[GrpType], Group) + + if callable(name): + return command(cls=cls, **attrs)(name) + + return command(name, cls, **attrs) + + +def _param_memo(f: t.Callable[..., t.Any], param: Parameter) -> None: + if isinstance(f, Command): + f.params.append(param) + else: + if not hasattr(f, "__click_params__"): + f.__click_params__ = [] # type: ignore + + f.__click_params__.append(param) # type: ignore + + +def argument( + *param_decls: str, cls: t.Optional[t.Type[Argument]] = None, **attrs: t.Any +) -> t.Callable[[FC], FC]: + """Attaches an argument to the command. All positional arguments are + passed as parameter declarations to :class:`Argument`; all keyword + arguments are forwarded unchanged (except ``cls``). + This is equivalent to creating an :class:`Argument` instance manually + and attaching it to the :attr:`Command.params` list. + + For the default argument class, refer to :class:`Argument` and + :class:`Parameter` for descriptions of parameters. + + :param cls: the argument class to instantiate. This defaults to + :class:`Argument`. + :param param_decls: Passed as positional arguments to the constructor of + ``cls``. + :param attrs: Passed as keyword arguments to the constructor of ``cls``. + """ + if cls is None: + cls = Argument + + def decorator(f: FC) -> FC: + _param_memo(f, cls(param_decls, **attrs)) + return f + + return decorator + + +def option( + *param_decls: str, cls: t.Optional[t.Type[Option]] = None, **attrs: t.Any +) -> t.Callable[[FC], FC]: + """Attaches an option to the command. All positional arguments are + passed as parameter declarations to :class:`Option`; all keyword + arguments are forwarded unchanged (except ``cls``). + This is equivalent to creating an :class:`Option` instance manually + and attaching it to the :attr:`Command.params` list. + + For the default option class, refer to :class:`Option` and + :class:`Parameter` for descriptions of parameters. + + :param cls: the option class to instantiate. This defaults to + :class:`Option`. + :param param_decls: Passed as positional arguments to the constructor of + ``cls``. + :param attrs: Passed as keyword arguments to the constructor of ``cls``. + """ + if cls is None: + cls = Option + + def decorator(f: FC) -> FC: + _param_memo(f, cls(param_decls, **attrs)) + return f + + return decorator + + +def confirmation_option(*param_decls: str, **kwargs: t.Any) -> t.Callable[[FC], FC]: + """Add a ``--yes`` option which shows a prompt before continuing if + not passed. If the prompt is declined, the program will exit. + + :param param_decls: One or more option names. Defaults to the single + value ``"--yes"``. + :param kwargs: Extra arguments are passed to :func:`option`. + """ + + def callback(ctx: Context, param: Parameter, value: bool) -> None: + if not value: + ctx.abort() + + if not param_decls: + param_decls = ("--yes",) + + kwargs.setdefault("is_flag", True) + kwargs.setdefault("callback", callback) + kwargs.setdefault("expose_value", False) + kwargs.setdefault("prompt", "Do you want to continue?") + kwargs.setdefault("help", "Confirm the action without prompting.") + return option(*param_decls, **kwargs) + + +def password_option(*param_decls: str, **kwargs: t.Any) -> t.Callable[[FC], FC]: + """Add a ``--password`` option which prompts for a password, hiding + input and asking to enter the value again for confirmation. + + :param param_decls: One or more option names. Defaults to the single + value ``"--password"``. + :param kwargs: Extra arguments are passed to :func:`option`. + """ + if not param_decls: + param_decls = ("--password",) + + kwargs.setdefault("prompt", True) + kwargs.setdefault("confirmation_prompt", True) + kwargs.setdefault("hide_input", True) + return option(*param_decls, **kwargs) + + +def version_option( + version: t.Optional[str] = None, + *param_decls: str, + package_name: t.Optional[str] = None, + prog_name: t.Optional[str] = None, + message: t.Optional[str] = None, + **kwargs: t.Any, +) -> t.Callable[[FC], FC]: + """Add a ``--version`` option which immediately prints the version + number and exits the program. + + If ``version`` is not provided, Click will try to detect it using + :func:`importlib.metadata.version` to get the version for the + ``package_name``. On Python < 3.8, the ``importlib_metadata`` + backport must be installed. + + If ``package_name`` is not provided, Click will try to detect it by + inspecting the stack frames. This will be used to detect the + version, so it must match the name of the installed package. + + :param version: The version number to show. If not provided, Click + will try to detect it. + :param param_decls: One or more option names. Defaults to the single + value ``"--version"``. + :param package_name: The package name to detect the version from. If + not provided, Click will try to detect it. + :param prog_name: The name of the CLI to show in the message. If not + provided, it will be detected from the command. + :param message: The message to show. The values ``%(prog)s``, + ``%(package)s``, and ``%(version)s`` are available. Defaults to + ``"%(prog)s, version %(version)s"``. + :param kwargs: Extra arguments are passed to :func:`option`. + :raise RuntimeError: ``version`` could not be detected. + + .. versionchanged:: 8.0 + Add the ``package_name`` parameter, and the ``%(package)s`` + value for messages. + + .. versionchanged:: 8.0 + Use :mod:`importlib.metadata` instead of ``pkg_resources``. The + version is detected based on the package name, not the entry + point name. The Python package name must match the installed + package name, or be passed with ``package_name=``. + """ + if message is None: + message = _("%(prog)s, version %(version)s") + + if version is None and package_name is None: + frame = inspect.currentframe() + f_back = frame.f_back if frame is not None else None + f_globals = f_back.f_globals if f_back is not None else None + # break reference cycle + # https://docs.python.org/3/library/inspect.html#the-interpreter-stack + del frame + + if f_globals is not None: + package_name = f_globals.get("__name__") + + if package_name == "__main__": + package_name = f_globals.get("__package__") + + if package_name: + package_name = package_name.partition(".")[0] + + def callback(ctx: Context, param: Parameter, value: bool) -> None: + if not value or ctx.resilient_parsing: + return + + nonlocal prog_name + nonlocal version + + if prog_name is None: + prog_name = ctx.find_root().info_name + + if version is None and package_name is not None: + metadata: t.Optional[types.ModuleType] + + try: + from importlib import metadata + except ImportError: + # Python < 3.8 + import importlib_metadata as metadata # type: ignore + + try: + version = metadata.version(package_name) # type: ignore + except metadata.PackageNotFoundError: # type: ignore + raise RuntimeError( + f"{package_name!r} is not installed. Try passing" + " 'package_name' instead." + ) from None + + if version is None: + raise RuntimeError( + f"Could not determine the version for {package_name!r} automatically." + ) + + echo( + message % {"prog": prog_name, "package": package_name, "version": version}, + color=ctx.color, + ) + ctx.exit() + + if not param_decls: + param_decls = ("--version",) + + kwargs.setdefault("is_flag", True) + kwargs.setdefault("expose_value", False) + kwargs.setdefault("is_eager", True) + kwargs.setdefault("help", _("Show the version and exit.")) + kwargs["callback"] = callback + return option(*param_decls, **kwargs) + + +class HelpOption(Option): + """Pre-configured ``--help`` option which immediately prints the help page + and exits the program. + """ + + def __init__( + self, + param_decls: t.Optional[t.Sequence[str]] = None, + **kwargs: t.Any, + ) -> None: + if not param_decls: + param_decls = ("--help",) + + kwargs.setdefault("is_flag", True) + kwargs.setdefault("expose_value", False) + kwargs.setdefault("is_eager", True) + kwargs.setdefault("help", _("Show this message and exit.")) + kwargs.setdefault("callback", self.show_help) + + super().__init__(param_decls, **kwargs) + + @staticmethod + def show_help(ctx: Context, param: Parameter, value: bool) -> None: + """Callback that print the help page on ```` and exits.""" + if value and not ctx.resilient_parsing: + echo(ctx.get_help(), color=ctx.color) + ctx.exit() + + +def help_option(*param_decls: str, **kwargs: t.Any) -> t.Callable[[FC], FC]: + """Decorator for the pre-configured ``--help`` option defined above. + + :param param_decls: One or more option names. Defaults to the single + value ``"--help"``. + :param kwargs: Extra arguments are passed to :func:`option`. + """ + kwargs.setdefault("cls", HelpOption) + return option(*param_decls, **kwargs) diff --git a/.venv/Lib/site-packages/click/exceptions.py b/.venv/Lib/site-packages/click/exceptions.py new file mode 100644 index 0000000..0b83151 --- /dev/null +++ b/.venv/Lib/site-packages/click/exceptions.py @@ -0,0 +1,296 @@ +import typing as t +from gettext import gettext as _ +from gettext import ngettext + +from ._compat import get_text_stderr +from .globals import resolve_color_default +from .utils import echo +from .utils import format_filename + +if t.TYPE_CHECKING: + from .core import Command + from .core import Context + from .core import Parameter + + +def _join_param_hints( + param_hint: t.Optional[t.Union[t.Sequence[str], str]], +) -> t.Optional[str]: + if param_hint is not None and not isinstance(param_hint, str): + return " / ".join(repr(x) for x in param_hint) + + return param_hint + + +class ClickException(Exception): + """An exception that Click can handle and show to the user.""" + + #: The exit code for this exception. + exit_code = 1 + + def __init__(self, message: str) -> None: + super().__init__(message) + # The context will be removed by the time we print the message, so cache + # the color settings here to be used later on (in `show`) + self.show_color: t.Optional[bool] = resolve_color_default() + self.message = message + + def format_message(self) -> str: + return self.message + + def __str__(self) -> str: + return self.message + + def show(self, file: t.Optional[t.IO[t.Any]] = None) -> None: + if file is None: + file = get_text_stderr() + + echo( + _("Error: {message}").format(message=self.format_message()), + file=file, + color=self.show_color, + ) + + +class UsageError(ClickException): + """An internal exception that signals a usage error. This typically + aborts any further handling. + + :param message: the error message to display. + :param ctx: optionally the context that caused this error. Click will + fill in the context automatically in some situations. + """ + + exit_code = 2 + + def __init__(self, message: str, ctx: t.Optional["Context"] = None) -> None: + super().__init__(message) + self.ctx = ctx + self.cmd: t.Optional[Command] = self.ctx.command if self.ctx else None + + def show(self, file: t.Optional[t.IO[t.Any]] = None) -> None: + if file is None: + file = get_text_stderr() + color = None + hint = "" + if ( + self.ctx is not None + and self.ctx.command.get_help_option(self.ctx) is not None + ): + hint = _("Try '{command} {option}' for help.").format( + command=self.ctx.command_path, option=self.ctx.help_option_names[0] + ) + hint = f"{hint}\n" + if self.ctx is not None: + color = self.ctx.color + echo(f"{self.ctx.get_usage()}\n{hint}", file=file, color=color) + echo( + _("Error: {message}").format(message=self.format_message()), + file=file, + color=color, + ) + + +class BadParameter(UsageError): + """An exception that formats out a standardized error message for a + bad parameter. This is useful when thrown from a callback or type as + Click will attach contextual information to it (for instance, which + parameter it is). + + .. versionadded:: 2.0 + + :param param: the parameter object that caused this error. This can + be left out, and Click will attach this info itself + if possible. + :param param_hint: a string that shows up as parameter name. This + can be used as alternative to `param` in cases + where custom validation should happen. If it is + a string it's used as such, if it's a list then + each item is quoted and separated. + """ + + def __init__( + self, + message: str, + ctx: t.Optional["Context"] = None, + param: t.Optional["Parameter"] = None, + param_hint: t.Optional[str] = None, + ) -> None: + super().__init__(message, ctx) + self.param = param + self.param_hint = param_hint + + def format_message(self) -> str: + if self.param_hint is not None: + param_hint = self.param_hint + elif self.param is not None: + param_hint = self.param.get_error_hint(self.ctx) # type: ignore + else: + return _("Invalid value: {message}").format(message=self.message) + + return _("Invalid value for {param_hint}: {message}").format( + param_hint=_join_param_hints(param_hint), message=self.message + ) + + +class MissingParameter(BadParameter): + """Raised if click required an option or argument but it was not + provided when invoking the script. + + .. versionadded:: 4.0 + + :param param_type: a string that indicates the type of the parameter. + The default is to inherit the parameter type from + the given `param`. Valid values are ``'parameter'``, + ``'option'`` or ``'argument'``. + """ + + def __init__( + self, + message: t.Optional[str] = None, + ctx: t.Optional["Context"] = None, + param: t.Optional["Parameter"] = None, + param_hint: t.Optional[str] = None, + param_type: t.Optional[str] = None, + ) -> None: + super().__init__(message or "", ctx, param, param_hint) + self.param_type = param_type + + def format_message(self) -> str: + if self.param_hint is not None: + param_hint: t.Optional[str] = self.param_hint + elif self.param is not None: + param_hint = self.param.get_error_hint(self.ctx) # type: ignore + else: + param_hint = None + + param_hint = _join_param_hints(param_hint) + param_hint = f" {param_hint}" if param_hint else "" + + param_type = self.param_type + if param_type is None and self.param is not None: + param_type = self.param.param_type_name + + msg = self.message + if self.param is not None: + msg_extra = self.param.type.get_missing_message(self.param) + if msg_extra: + if msg: + msg += f". {msg_extra}" + else: + msg = msg_extra + + msg = f" {msg}" if msg else "" + + # Translate param_type for known types. + if param_type == "argument": + missing = _("Missing argument") + elif param_type == "option": + missing = _("Missing option") + elif param_type == "parameter": + missing = _("Missing parameter") + else: + missing = _("Missing {param_type}").format(param_type=param_type) + + return f"{missing}{param_hint}.{msg}" + + def __str__(self) -> str: + if not self.message: + param_name = self.param.name if self.param else None + return _("Missing parameter: {param_name}").format(param_name=param_name) + else: + return self.message + + +class NoSuchOption(UsageError): + """Raised if click attempted to handle an option that does not + exist. + + .. versionadded:: 4.0 + """ + + def __init__( + self, + option_name: str, + message: t.Optional[str] = None, + possibilities: t.Optional[t.Sequence[str]] = None, + ctx: t.Optional["Context"] = None, + ) -> None: + if message is None: + message = _("No such option: {name}").format(name=option_name) + + super().__init__(message, ctx) + self.option_name = option_name + self.possibilities = possibilities + + def format_message(self) -> str: + if not self.possibilities: + return self.message + + possibility_str = ", ".join(sorted(self.possibilities)) + suggest = ngettext( + "Did you mean {possibility}?", + "(Possible options: {possibilities})", + len(self.possibilities), + ).format(possibility=possibility_str, possibilities=possibility_str) + return f"{self.message} {suggest}" + + +class BadOptionUsage(UsageError): + """Raised if an option is generally supplied but the use of the option + was incorrect. This is for instance raised if the number of arguments + for an option is not correct. + + .. versionadded:: 4.0 + + :param option_name: the name of the option being used incorrectly. + """ + + def __init__( + self, option_name: str, message: str, ctx: t.Optional["Context"] = None + ) -> None: + super().__init__(message, ctx) + self.option_name = option_name + + +class BadArgumentUsage(UsageError): + """Raised if an argument is generally supplied but the use of the argument + was incorrect. This is for instance raised if the number of values + for an argument is not correct. + + .. versionadded:: 6.0 + """ + + +class FileError(ClickException): + """Raised if a file cannot be opened.""" + + def __init__(self, filename: str, hint: t.Optional[str] = None) -> None: + if hint is None: + hint = _("unknown error") + + super().__init__(hint) + self.ui_filename: str = format_filename(filename) + self.filename = filename + + def format_message(self) -> str: + return _("Could not open file {filename!r}: {message}").format( + filename=self.ui_filename, message=self.message + ) + + +class Abort(RuntimeError): + """An internal signalling exception that signals Click to abort.""" + + +class Exit(RuntimeError): + """An exception that indicates that the application should exit with some + status code. + + :param code: the status code to exit with. + """ + + __slots__ = ("exit_code",) + + def __init__(self, code: int = 0) -> None: + self.exit_code: int = code diff --git a/.venv/Lib/site-packages/click/formatting.py b/.venv/Lib/site-packages/click/formatting.py new file mode 100644 index 0000000..ddd2a2f --- /dev/null +++ b/.venv/Lib/site-packages/click/formatting.py @@ -0,0 +1,301 @@ +import typing as t +from contextlib import contextmanager +from gettext import gettext as _ + +from ._compat import term_len +from .parser import split_opt + +# Can force a width. This is used by the test system +FORCED_WIDTH: t.Optional[int] = None + + +def measure_table(rows: t.Iterable[t.Tuple[str, str]]) -> t.Tuple[int, ...]: + widths: t.Dict[int, int] = {} + + for row in rows: + for idx, col in enumerate(row): + widths[idx] = max(widths.get(idx, 0), term_len(col)) + + return tuple(y for x, y in sorted(widths.items())) + + +def iter_rows( + rows: t.Iterable[t.Tuple[str, str]], col_count: int +) -> t.Iterator[t.Tuple[str, ...]]: + for row in rows: + yield row + ("",) * (col_count - len(row)) + + +def wrap_text( + text: str, + width: int = 78, + initial_indent: str = "", + subsequent_indent: str = "", + preserve_paragraphs: bool = False, +) -> str: + """A helper function that intelligently wraps text. By default, it + assumes that it operates on a single paragraph of text but if the + `preserve_paragraphs` parameter is provided it will intelligently + handle paragraphs (defined by two empty lines). + + If paragraphs are handled, a paragraph can be prefixed with an empty + line containing the ``\\b`` character (``\\x08``) to indicate that + no rewrapping should happen in that block. + + :param text: the text that should be rewrapped. + :param width: the maximum width for the text. + :param initial_indent: the initial indent that should be placed on the + first line as a string. + :param subsequent_indent: the indent string that should be placed on + each consecutive line. + :param preserve_paragraphs: if this flag is set then the wrapping will + intelligently handle paragraphs. + """ + from ._textwrap import TextWrapper + + text = text.expandtabs() + wrapper = TextWrapper( + width, + initial_indent=initial_indent, + subsequent_indent=subsequent_indent, + replace_whitespace=False, + ) + if not preserve_paragraphs: + return wrapper.fill(text) + + p: t.List[t.Tuple[int, bool, str]] = [] + buf: t.List[str] = [] + indent = None + + def _flush_par() -> None: + if not buf: + return + if buf[0].strip() == "\b": + p.append((indent or 0, True, "\n".join(buf[1:]))) + else: + p.append((indent or 0, False, " ".join(buf))) + del buf[:] + + for line in text.splitlines(): + if not line: + _flush_par() + indent = None + else: + if indent is None: + orig_len = term_len(line) + line = line.lstrip() + indent = orig_len - term_len(line) + buf.append(line) + _flush_par() + + rv = [] + for indent, raw, text in p: + with wrapper.extra_indent(" " * indent): + if raw: + rv.append(wrapper.indent_only(text)) + else: + rv.append(wrapper.fill(text)) + + return "\n\n".join(rv) + + +class HelpFormatter: + """This class helps with formatting text-based help pages. It's + usually just needed for very special internal cases, but it's also + exposed so that developers can write their own fancy outputs. + + At present, it always writes into memory. + + :param indent_increment: the additional increment for each level. + :param width: the width for the text. This defaults to the terminal + width clamped to a maximum of 78. + """ + + def __init__( + self, + indent_increment: int = 2, + width: t.Optional[int] = None, + max_width: t.Optional[int] = None, + ) -> None: + import shutil + + self.indent_increment = indent_increment + if max_width is None: + max_width = 80 + if width is None: + width = FORCED_WIDTH + if width is None: + width = max(min(shutil.get_terminal_size().columns, max_width) - 2, 50) + self.width = width + self.current_indent = 0 + self.buffer: t.List[str] = [] + + def write(self, string: str) -> None: + """Writes a unicode string into the internal buffer.""" + self.buffer.append(string) + + def indent(self) -> None: + """Increases the indentation.""" + self.current_indent += self.indent_increment + + def dedent(self) -> None: + """Decreases the indentation.""" + self.current_indent -= self.indent_increment + + def write_usage( + self, prog: str, args: str = "", prefix: t.Optional[str] = None + ) -> None: + """Writes a usage line into the buffer. + + :param prog: the program name. + :param args: whitespace separated list of arguments. + :param prefix: The prefix for the first line. Defaults to + ``"Usage: "``. + """ + if prefix is None: + prefix = f"{_('Usage:')} " + + usage_prefix = f"{prefix:>{self.current_indent}}{prog} " + text_width = self.width - self.current_indent + + if text_width >= (term_len(usage_prefix) + 20): + # The arguments will fit to the right of the prefix. + indent = " " * term_len(usage_prefix) + self.write( + wrap_text( + args, + text_width, + initial_indent=usage_prefix, + subsequent_indent=indent, + ) + ) + else: + # The prefix is too long, put the arguments on the next line. + self.write(usage_prefix) + self.write("\n") + indent = " " * (max(self.current_indent, term_len(prefix)) + 4) + self.write( + wrap_text( + args, text_width, initial_indent=indent, subsequent_indent=indent + ) + ) + + self.write("\n") + + def write_heading(self, heading: str) -> None: + """Writes a heading into the buffer.""" + self.write(f"{'':>{self.current_indent}}{heading}:\n") + + def write_paragraph(self) -> None: + """Writes a paragraph into the buffer.""" + if self.buffer: + self.write("\n") + + def write_text(self, text: str) -> None: + """Writes re-indented text into the buffer. This rewraps and + preserves paragraphs. + """ + indent = " " * self.current_indent + self.write( + wrap_text( + text, + self.width, + initial_indent=indent, + subsequent_indent=indent, + preserve_paragraphs=True, + ) + ) + self.write("\n") + + def write_dl( + self, + rows: t.Sequence[t.Tuple[str, str]], + col_max: int = 30, + col_spacing: int = 2, + ) -> None: + """Writes a definition list into the buffer. This is how options + and commands are usually formatted. + + :param rows: a list of two item tuples for the terms and values. + :param col_max: the maximum width of the first column. + :param col_spacing: the number of spaces between the first and + second column. + """ + rows = list(rows) + widths = measure_table(rows) + if len(widths) != 2: + raise TypeError("Expected two columns for definition list") + + first_col = min(widths[0], col_max) + col_spacing + + for first, second in iter_rows(rows, len(widths)): + self.write(f"{'':>{self.current_indent}}{first}") + if not second: + self.write("\n") + continue + if term_len(first) <= first_col - col_spacing: + self.write(" " * (first_col - term_len(first))) + else: + self.write("\n") + self.write(" " * (first_col + self.current_indent)) + + text_width = max(self.width - first_col - 2, 10) + wrapped_text = wrap_text(second, text_width, preserve_paragraphs=True) + lines = wrapped_text.splitlines() + + if lines: + self.write(f"{lines[0]}\n") + + for line in lines[1:]: + self.write(f"{'':>{first_col + self.current_indent}}{line}\n") + else: + self.write("\n") + + @contextmanager + def section(self, name: str) -> t.Iterator[None]: + """Helpful context manager that writes a paragraph, a heading, + and the indents. + + :param name: the section name that is written as heading. + """ + self.write_paragraph() + self.write_heading(name) + self.indent() + try: + yield + finally: + self.dedent() + + @contextmanager + def indentation(self) -> t.Iterator[None]: + """A context manager that increases the indentation.""" + self.indent() + try: + yield + finally: + self.dedent() + + def getvalue(self) -> str: + """Returns the buffer contents.""" + return "".join(self.buffer) + + +def join_options(options: t.Sequence[str]) -> t.Tuple[str, bool]: + """Given a list of option strings this joins them in the most appropriate + way and returns them in the form ``(formatted_string, + any_prefix_is_slash)`` where the second item in the tuple is a flag that + indicates if any of the option prefixes was a slash. + """ + rv = [] + any_prefix_is_slash = False + + for opt in options: + prefix = split_opt(opt)[0] + + if prefix == "/": + any_prefix_is_slash = True + + rv.append((len(prefix), opt)) + + rv.sort(key=lambda x: x[0]) + return ", ".join(x[1] for x in rv), any_prefix_is_slash diff --git a/.venv/Lib/site-packages/click/globals.py b/.venv/Lib/site-packages/click/globals.py new file mode 100644 index 0000000..191e712 --- /dev/null +++ b/.venv/Lib/site-packages/click/globals.py @@ -0,0 +1,67 @@ +import typing as t +from threading import local + +if t.TYPE_CHECKING: + import typing_extensions as te + + from .core import Context + +_local = local() + + +@t.overload +def get_current_context(silent: "te.Literal[False]" = False) -> "Context": ... + + +@t.overload +def get_current_context(silent: bool = ...) -> t.Optional["Context"]: ... + + +def get_current_context(silent: bool = False) -> t.Optional["Context"]: + """Returns the current click context. This can be used as a way to + access the current context object from anywhere. This is a more implicit + alternative to the :func:`pass_context` decorator. This function is + primarily useful for helpers such as :func:`echo` which might be + interested in changing its behavior based on the current context. + + To push the current context, :meth:`Context.scope` can be used. + + .. versionadded:: 5.0 + + :param silent: if set to `True` the return value is `None` if no context + is available. The default behavior is to raise a + :exc:`RuntimeError`. + """ + try: + return t.cast("Context", _local.stack[-1]) + except (AttributeError, IndexError) as e: + if not silent: + raise RuntimeError("There is no active click context.") from e + + return None + + +def push_context(ctx: "Context") -> None: + """Pushes a new context to the current stack.""" + _local.__dict__.setdefault("stack", []).append(ctx) + + +def pop_context() -> None: + """Removes the top level from the stack.""" + _local.stack.pop() + + +def resolve_color_default(color: t.Optional[bool] = None) -> t.Optional[bool]: + """Internal helper to get the default value of the color flag. If a + value is passed it's returned unchanged, otherwise it's looked up from + the current context. + """ + if color is not None: + return color + + ctx = get_current_context(silent=True) + + if ctx is not None: + return ctx.color + + return None diff --git a/.venv/Lib/site-packages/click/parser.py b/.venv/Lib/site-packages/click/parser.py new file mode 100644 index 0000000..600b843 --- /dev/null +++ b/.venv/Lib/site-packages/click/parser.py @@ -0,0 +1,531 @@ +""" +This module started out as largely a copy paste from the stdlib's +optparse module with the features removed that we do not need from +optparse because we implement them in Click on a higher level (for +instance type handling, help formatting and a lot more). + +The plan is to remove more and more from here over time. + +The reason this is a different module and not optparse from the stdlib +is that there are differences in 2.x and 3.x about the error messages +generated and optparse in the stdlib uses gettext for no good reason +and might cause us issues. + +Click uses parts of optparse written by Gregory P. Ward and maintained +by the Python Software Foundation. This is limited to code in parser.py. + +Copyright 2001-2006 Gregory P. Ward. All rights reserved. +Copyright 2002-2006 Python Software Foundation. All rights reserved. +""" + +# This code uses parts of optparse written by Gregory P. Ward and +# maintained by the Python Software Foundation. +# Copyright 2001-2006 Gregory P. Ward +# Copyright 2002-2006 Python Software Foundation +import typing as t +from collections import deque +from gettext import gettext as _ +from gettext import ngettext + +from .exceptions import BadArgumentUsage +from .exceptions import BadOptionUsage +from .exceptions import NoSuchOption +from .exceptions import UsageError + +if t.TYPE_CHECKING: + import typing_extensions as te + + from .core import Argument as CoreArgument + from .core import Context + from .core import Option as CoreOption + from .core import Parameter as CoreParameter + +V = t.TypeVar("V") + +# Sentinel value that indicates an option was passed as a flag without a +# value but is not a flag option. Option.consume_value uses this to +# prompt or use the flag_value. +_flag_needs_value = object() + + +def _unpack_args( + args: t.Sequence[str], nargs_spec: t.Sequence[int] +) -> t.Tuple[t.Sequence[t.Union[str, t.Sequence[t.Optional[str]], None]], t.List[str]]: + """Given an iterable of arguments and an iterable of nargs specifications, + it returns a tuple with all the unpacked arguments at the first index + and all remaining arguments as the second. + + The nargs specification is the number of arguments that should be consumed + or `-1` to indicate that this position should eat up all the remainders. + + Missing items are filled with `None`. + """ + args = deque(args) + nargs_spec = deque(nargs_spec) + rv: t.List[t.Union[str, t.Tuple[t.Optional[str], ...], None]] = [] + spos: t.Optional[int] = None + + def _fetch(c: "te.Deque[V]") -> t.Optional[V]: + try: + if spos is None: + return c.popleft() + else: + return c.pop() + except IndexError: + return None + + while nargs_spec: + nargs = _fetch(nargs_spec) + + if nargs is None: + continue + + if nargs == 1: + rv.append(_fetch(args)) + elif nargs > 1: + x = [_fetch(args) for _ in range(nargs)] + + # If we're reversed, we're pulling in the arguments in reverse, + # so we need to turn them around. + if spos is not None: + x.reverse() + + rv.append(tuple(x)) + elif nargs < 0: + if spos is not None: + raise TypeError("Cannot have two nargs < 0") + + spos = len(rv) + rv.append(None) + + # spos is the position of the wildcard (star). If it's not `None`, + # we fill it with the remainder. + if spos is not None: + rv[spos] = tuple(args) + args = [] + rv[spos + 1 :] = reversed(rv[spos + 1 :]) + + return tuple(rv), list(args) + + +def split_opt(opt: str) -> t.Tuple[str, str]: + first = opt[:1] + if first.isalnum(): + return "", opt + if opt[1:2] == first: + return opt[:2], opt[2:] + return first, opt[1:] + + +def normalize_opt(opt: str, ctx: t.Optional["Context"]) -> str: + if ctx is None or ctx.token_normalize_func is None: + return opt + prefix, opt = split_opt(opt) + return f"{prefix}{ctx.token_normalize_func(opt)}" + + +def split_arg_string(string: str) -> t.List[str]: + """Split an argument string as with :func:`shlex.split`, but don't + fail if the string is incomplete. Ignores a missing closing quote or + incomplete escape sequence and uses the partial token as-is. + + .. code-block:: python + + split_arg_string("example 'my file") + ["example", "my file"] + + split_arg_string("example my\\") + ["example", "my"] + + :param string: String to split. + """ + import shlex + + lex = shlex.shlex(string, posix=True) + lex.whitespace_split = True + lex.commenters = "" + out = [] + + try: + for token in lex: + out.append(token) + except ValueError: + # Raised when end-of-string is reached in an invalid state. Use + # the partial token as-is. The quote or escape character is in + # lex.state, not lex.token. + out.append(lex.token) + + return out + + +class Option: + def __init__( + self, + obj: "CoreOption", + opts: t.Sequence[str], + dest: t.Optional[str], + action: t.Optional[str] = None, + nargs: int = 1, + const: t.Optional[t.Any] = None, + ): + self._short_opts = [] + self._long_opts = [] + self.prefixes: t.Set[str] = set() + + for opt in opts: + prefix, value = split_opt(opt) + if not prefix: + raise ValueError(f"Invalid start character for option ({opt})") + self.prefixes.add(prefix[0]) + if len(prefix) == 1 and len(value) == 1: + self._short_opts.append(opt) + else: + self._long_opts.append(opt) + self.prefixes.add(prefix) + + if action is None: + action = "store" + + self.dest = dest + self.action = action + self.nargs = nargs + self.const = const + self.obj = obj + + @property + def takes_value(self) -> bool: + return self.action in ("store", "append") + + def process(self, value: t.Any, state: "ParsingState") -> None: + if self.action == "store": + state.opts[self.dest] = value # type: ignore + elif self.action == "store_const": + state.opts[self.dest] = self.const # type: ignore + elif self.action == "append": + state.opts.setdefault(self.dest, []).append(value) # type: ignore + elif self.action == "append_const": + state.opts.setdefault(self.dest, []).append(self.const) # type: ignore + elif self.action == "count": + state.opts[self.dest] = state.opts.get(self.dest, 0) + 1 # type: ignore + else: + raise ValueError(f"unknown action '{self.action}'") + state.order.append(self.obj) + + +class Argument: + def __init__(self, obj: "CoreArgument", dest: t.Optional[str], nargs: int = 1): + self.dest = dest + self.nargs = nargs + self.obj = obj + + def process( + self, + value: t.Union[t.Optional[str], t.Sequence[t.Optional[str]]], + state: "ParsingState", + ) -> None: + if self.nargs > 1: + assert value is not None + holes = sum(1 for x in value if x is None) + if holes == len(value): + value = None + elif holes != 0: + raise BadArgumentUsage( + _("Argument {name!r} takes {nargs} values.").format( + name=self.dest, nargs=self.nargs + ) + ) + + if self.nargs == -1 and self.obj.envvar is not None and value == (): + # Replace empty tuple with None so that a value from the + # environment may be tried. + value = None + + state.opts[self.dest] = value # type: ignore + state.order.append(self.obj) + + +class ParsingState: + def __init__(self, rargs: t.List[str]) -> None: + self.opts: t.Dict[str, t.Any] = {} + self.largs: t.List[str] = [] + self.rargs = rargs + self.order: t.List[CoreParameter] = [] + + +class OptionParser: + """The option parser is an internal class that is ultimately used to + parse options and arguments. It's modelled after optparse and brings + a similar but vastly simplified API. It should generally not be used + directly as the high level Click classes wrap it for you. + + It's not nearly as extensible as optparse or argparse as it does not + implement features that are implemented on a higher level (such as + types or defaults). + + :param ctx: optionally the :class:`~click.Context` where this parser + should go with. + """ + + def __init__(self, ctx: t.Optional["Context"] = None) -> None: + #: The :class:`~click.Context` for this parser. This might be + #: `None` for some advanced use cases. + self.ctx = ctx + #: This controls how the parser deals with interspersed arguments. + #: If this is set to `False`, the parser will stop on the first + #: non-option. Click uses this to implement nested subcommands + #: safely. + self.allow_interspersed_args: bool = True + #: This tells the parser how to deal with unknown options. By + #: default it will error out (which is sensible), but there is a + #: second mode where it will ignore it and continue processing + #: after shifting all the unknown options into the resulting args. + self.ignore_unknown_options: bool = False + + if ctx is not None: + self.allow_interspersed_args = ctx.allow_interspersed_args + self.ignore_unknown_options = ctx.ignore_unknown_options + + self._short_opt: t.Dict[str, Option] = {} + self._long_opt: t.Dict[str, Option] = {} + self._opt_prefixes = {"-", "--"} + self._args: t.List[Argument] = [] + + def add_option( + self, + obj: "CoreOption", + opts: t.Sequence[str], + dest: t.Optional[str], + action: t.Optional[str] = None, + nargs: int = 1, + const: t.Optional[t.Any] = None, + ) -> None: + """Adds a new option named `dest` to the parser. The destination + is not inferred (unlike with optparse) and needs to be explicitly + provided. Action can be any of ``store``, ``store_const``, + ``append``, ``append_const`` or ``count``. + + The `obj` can be used to identify the option in the order list + that is returned from the parser. + """ + opts = [normalize_opt(opt, self.ctx) for opt in opts] + option = Option(obj, opts, dest, action=action, nargs=nargs, const=const) + self._opt_prefixes.update(option.prefixes) + for opt in option._short_opts: + self._short_opt[opt] = option + for opt in option._long_opts: + self._long_opt[opt] = option + + def add_argument( + self, obj: "CoreArgument", dest: t.Optional[str], nargs: int = 1 + ) -> None: + """Adds a positional argument named `dest` to the parser. + + The `obj` can be used to identify the option in the order list + that is returned from the parser. + """ + self._args.append(Argument(obj, dest=dest, nargs=nargs)) + + def parse_args( + self, args: t.List[str] + ) -> t.Tuple[t.Dict[str, t.Any], t.List[str], t.List["CoreParameter"]]: + """Parses positional arguments and returns ``(values, args, order)`` + for the parsed options and arguments as well as the leftover + arguments if there are any. The order is a list of objects as they + appear on the command line. If arguments appear multiple times they + will be memorized multiple times as well. + """ + state = ParsingState(args) + try: + self._process_args_for_options(state) + self._process_args_for_args(state) + except UsageError: + if self.ctx is None or not self.ctx.resilient_parsing: + raise + return state.opts, state.largs, state.order + + def _process_args_for_args(self, state: ParsingState) -> None: + pargs, args = _unpack_args( + state.largs + state.rargs, [x.nargs for x in self._args] + ) + + for idx, arg in enumerate(self._args): + arg.process(pargs[idx], state) + + state.largs = args + state.rargs = [] + + def _process_args_for_options(self, state: ParsingState) -> None: + while state.rargs: + arg = state.rargs.pop(0) + arglen = len(arg) + # Double dashes always handled explicitly regardless of what + # prefixes are valid. + if arg == "--": + return + elif arg[:1] in self._opt_prefixes and arglen > 1: + self._process_opts(arg, state) + elif self.allow_interspersed_args: + state.largs.append(arg) + else: + state.rargs.insert(0, arg) + return + + # Say this is the original argument list: + # [arg0, arg1, ..., arg(i-1), arg(i), arg(i+1), ..., arg(N-1)] + # ^ + # (we are about to process arg(i)). + # + # Then rargs is [arg(i), ..., arg(N-1)] and largs is a *subset* of + # [arg0, ..., arg(i-1)] (any options and their arguments will have + # been removed from largs). + # + # The while loop will usually consume 1 or more arguments per pass. + # If it consumes 1 (eg. arg is an option that takes no arguments), + # then after _process_arg() is done the situation is: + # + # largs = subset of [arg0, ..., arg(i)] + # rargs = [arg(i+1), ..., arg(N-1)] + # + # If allow_interspersed_args is false, largs will always be + # *empty* -- still a subset of [arg0, ..., arg(i-1)], but + # not a very interesting subset! + + def _match_long_opt( + self, opt: str, explicit_value: t.Optional[str], state: ParsingState + ) -> None: + if opt not in self._long_opt: + from difflib import get_close_matches + + possibilities = get_close_matches(opt, self._long_opt) + raise NoSuchOption(opt, possibilities=possibilities, ctx=self.ctx) + + option = self._long_opt[opt] + if option.takes_value: + # At this point it's safe to modify rargs by injecting the + # explicit value, because no exception is raised in this + # branch. This means that the inserted value will be fully + # consumed. + if explicit_value is not None: + state.rargs.insert(0, explicit_value) + + value = self._get_value_from_state(opt, option, state) + + elif explicit_value is not None: + raise BadOptionUsage( + opt, _("Option {name!r} does not take a value.").format(name=opt) + ) + + else: + value = None + + option.process(value, state) + + def _match_short_opt(self, arg: str, state: ParsingState) -> None: + stop = False + i = 1 + prefix = arg[0] + unknown_options = [] + + for ch in arg[1:]: + opt = normalize_opt(f"{prefix}{ch}", self.ctx) + option = self._short_opt.get(opt) + i += 1 + + if not option: + if self.ignore_unknown_options: + unknown_options.append(ch) + continue + raise NoSuchOption(opt, ctx=self.ctx) + if option.takes_value: + # Any characters left in arg? Pretend they're the + # next arg, and stop consuming characters of arg. + if i < len(arg): + state.rargs.insert(0, arg[i:]) + stop = True + + value = self._get_value_from_state(opt, option, state) + + else: + value = None + + option.process(value, state) + + if stop: + break + + # If we got any unknown options we recombine the string of the + # remaining options and re-attach the prefix, then report that + # to the state as new larg. This way there is basic combinatorics + # that can be achieved while still ignoring unknown arguments. + if self.ignore_unknown_options and unknown_options: + state.largs.append(f"{prefix}{''.join(unknown_options)}") + + def _get_value_from_state( + self, option_name: str, option: Option, state: ParsingState + ) -> t.Any: + nargs = option.nargs + + if len(state.rargs) < nargs: + if option.obj._flag_needs_value: + # Option allows omitting the value. + value = _flag_needs_value + else: + raise BadOptionUsage( + option_name, + ngettext( + "Option {name!r} requires an argument.", + "Option {name!r} requires {nargs} arguments.", + nargs, + ).format(name=option_name, nargs=nargs), + ) + elif nargs == 1: + next_rarg = state.rargs[0] + + if ( + option.obj._flag_needs_value + and isinstance(next_rarg, str) + and next_rarg[:1] in self._opt_prefixes + and len(next_rarg) > 1 + ): + # The next arg looks like the start of an option, don't + # use it as the value if omitting the value is allowed. + value = _flag_needs_value + else: + value = state.rargs.pop(0) + else: + value = tuple(state.rargs[:nargs]) + del state.rargs[:nargs] + + return value + + def _process_opts(self, arg: str, state: ParsingState) -> None: + explicit_value = None + # Long option handling happens in two parts. The first part is + # supporting explicitly attached values. In any case, we will try + # to long match the option first. + if "=" in arg: + long_opt, explicit_value = arg.split("=", 1) + else: + long_opt = arg + norm_long_opt = normalize_opt(long_opt, self.ctx) + + # At this point we will match the (assumed) long option through + # the long option matching code. Note that this allows options + # like "-foo" to be matched as long options. + try: + self._match_long_opt(norm_long_opt, explicit_value, state) + except NoSuchOption: + # At this point the long option matching failed, and we need + # to try with short options. However there is a special rule + # which says, that if we have a two character options prefix + # (applies to "--foo" for instance), we do not dispatch to the + # short option code and will instead raise the no option + # error. + if arg[:2] not in self._opt_prefixes: + self._match_short_opt(arg, state) + return + + if not self.ignore_unknown_options: + raise + + state.largs.append(arg) diff --git a/.venv/Lib/site-packages/click/py.typed b/.venv/Lib/site-packages/click/py.typed new file mode 100644 index 0000000..e69de29 diff --git a/.venv/Lib/site-packages/click/shell_completion.py b/.venv/Lib/site-packages/click/shell_completion.py new file mode 100644 index 0000000..07d0f09 --- /dev/null +++ b/.venv/Lib/site-packages/click/shell_completion.py @@ -0,0 +1,603 @@ +import os +import re +import typing as t +from gettext import gettext as _ + +from .core import Argument +from .core import BaseCommand +from .core import Context +from .core import MultiCommand +from .core import Option +from .core import Parameter +from .core import ParameterSource +from .parser import split_arg_string +from .utils import echo + + +def shell_complete( + cli: BaseCommand, + ctx_args: t.MutableMapping[str, t.Any], + prog_name: str, + complete_var: str, + instruction: str, +) -> int: + """Perform shell completion for the given CLI program. + + :param cli: Command being called. + :param ctx_args: Extra arguments to pass to + ``cli.make_context``. + :param prog_name: Name of the executable in the shell. + :param complete_var: Name of the environment variable that holds + the completion instruction. + :param instruction: Value of ``complete_var`` with the completion + instruction and shell, in the form ``instruction_shell``. + :return: Status code to exit with. + """ + shell, _, instruction = instruction.partition("_") + comp_cls = get_completion_class(shell) + + if comp_cls is None: + return 1 + + comp = comp_cls(cli, ctx_args, prog_name, complete_var) + + if instruction == "source": + echo(comp.source()) + return 0 + + if instruction == "complete": + echo(comp.complete()) + return 0 + + return 1 + + +class CompletionItem: + """Represents a completion value and metadata about the value. The + default metadata is ``type`` to indicate special shell handling, + and ``help`` if a shell supports showing a help string next to the + value. + + Arbitrary parameters can be passed when creating the object, and + accessed using ``item.attr``. If an attribute wasn't passed, + accessing it returns ``None``. + + :param value: The completion suggestion. + :param type: Tells the shell script to provide special completion + support for the type. Click uses ``"dir"`` and ``"file"``. + :param help: String shown next to the value if supported. + :param kwargs: Arbitrary metadata. The built-in implementations + don't use this, but custom type completions paired with custom + shell support could use it. + """ + + __slots__ = ("value", "type", "help", "_info") + + def __init__( + self, + value: t.Any, + type: str = "plain", + help: t.Optional[str] = None, + **kwargs: t.Any, + ) -> None: + self.value: t.Any = value + self.type: str = type + self.help: t.Optional[str] = help + self._info = kwargs + + def __getattr__(self, name: str) -> t.Any: + return self._info.get(name) + + +# Only Bash >= 4.4 has the nosort option. +_SOURCE_BASH = """\ +%(complete_func)s() { + local IFS=$'\\n' + local response + + response=$(env COMP_WORDS="${COMP_WORDS[*]}" COMP_CWORD=$COMP_CWORD \ +%(complete_var)s=bash_complete $1) + + for completion in $response; do + IFS=',' read type value <<< "$completion" + + if [[ $type == 'dir' ]]; then + COMPREPLY=() + compopt -o dirnames + elif [[ $type == 'file' ]]; then + COMPREPLY=() + compopt -o default + elif [[ $type == 'plain' ]]; then + COMPREPLY+=($value) + fi + done + + return 0 +} + +%(complete_func)s_setup() { + complete -o nosort -F %(complete_func)s %(prog_name)s +} + +%(complete_func)s_setup; +""" + +_SOURCE_ZSH = """\ +#compdef %(prog_name)s + +%(complete_func)s() { + local -a completions + local -a completions_with_descriptions + local -a response + (( ! $+commands[%(prog_name)s] )) && return 1 + + response=("${(@f)$(env COMP_WORDS="${words[*]}" COMP_CWORD=$((CURRENT-1)) \ +%(complete_var)s=zsh_complete %(prog_name)s)}") + + for type key descr in ${response}; do + if [[ "$type" == "plain" ]]; then + if [[ "$descr" == "_" ]]; then + completions+=("$key") + else + completions_with_descriptions+=("$key":"$descr") + fi + elif [[ "$type" == "dir" ]]; then + _path_files -/ + elif [[ "$type" == "file" ]]; then + _path_files -f + fi + done + + if [ -n "$completions_with_descriptions" ]; then + _describe -V unsorted completions_with_descriptions -U + fi + + if [ -n "$completions" ]; then + compadd -U -V unsorted -a completions + fi +} + +if [[ $zsh_eval_context[-1] == loadautofunc ]]; then + # autoload from fpath, call function directly + %(complete_func)s "$@" +else + # eval/source/. command, register function for later + compdef %(complete_func)s %(prog_name)s +fi +""" + +_SOURCE_FISH = """\ +function %(complete_func)s; + set -l response (env %(complete_var)s=fish_complete COMP_WORDS=(commandline -cp) \ +COMP_CWORD=(commandline -t) %(prog_name)s); + + for completion in $response; + set -l metadata (string split "," $completion); + + if test $metadata[1] = "dir"; + __fish_complete_directories $metadata[2]; + else if test $metadata[1] = "file"; + __fish_complete_path $metadata[2]; + else if test $metadata[1] = "plain"; + echo $metadata[2]; + end; + end; +end; + +complete --no-files --command %(prog_name)s --arguments \ +"(%(complete_func)s)"; +""" + + +class ShellComplete: + """Base class for providing shell completion support. A subclass for + a given shell will override attributes and methods to implement the + completion instructions (``source`` and ``complete``). + + :param cli: Command being called. + :param prog_name: Name of the executable in the shell. + :param complete_var: Name of the environment variable that holds + the completion instruction. + + .. versionadded:: 8.0 + """ + + name: t.ClassVar[str] + """Name to register the shell as with :func:`add_completion_class`. + This is used in completion instructions (``{name}_source`` and + ``{name}_complete``). + """ + + source_template: t.ClassVar[str] + """Completion script template formatted by :meth:`source`. This must + be provided by subclasses. + """ + + def __init__( + self, + cli: BaseCommand, + ctx_args: t.MutableMapping[str, t.Any], + prog_name: str, + complete_var: str, + ) -> None: + self.cli = cli + self.ctx_args = ctx_args + self.prog_name = prog_name + self.complete_var = complete_var + + @property + def func_name(self) -> str: + """The name of the shell function defined by the completion + script. + """ + safe_name = re.sub(r"\W*", "", self.prog_name.replace("-", "_"), flags=re.ASCII) + return f"_{safe_name}_completion" + + def source_vars(self) -> t.Dict[str, t.Any]: + """Vars for formatting :attr:`source_template`. + + By default this provides ``complete_func``, ``complete_var``, + and ``prog_name``. + """ + return { + "complete_func": self.func_name, + "complete_var": self.complete_var, + "prog_name": self.prog_name, + } + + def source(self) -> str: + """Produce the shell script that defines the completion + function. By default this ``%``-style formats + :attr:`source_template` with the dict returned by + :meth:`source_vars`. + """ + return self.source_template % self.source_vars() + + def get_completion_args(self) -> t.Tuple[t.List[str], str]: + """Use the env vars defined by the shell script to return a + tuple of ``args, incomplete``. This must be implemented by + subclasses. + """ + raise NotImplementedError + + def get_completions( + self, args: t.List[str], incomplete: str + ) -> t.List[CompletionItem]: + """Determine the context and last complete command or parameter + from the complete args. Call that object's ``shell_complete`` + method to get the completions for the incomplete value. + + :param args: List of complete args before the incomplete value. + :param incomplete: Value being completed. May be empty. + """ + ctx = _resolve_context(self.cli, self.ctx_args, self.prog_name, args) + obj, incomplete = _resolve_incomplete(ctx, args, incomplete) + return obj.shell_complete(ctx, incomplete) + + def format_completion(self, item: CompletionItem) -> str: + """Format a completion item into the form recognized by the + shell script. This must be implemented by subclasses. + + :param item: Completion item to format. + """ + raise NotImplementedError + + def complete(self) -> str: + """Produce the completion data to send back to the shell. + + By default this calls :meth:`get_completion_args`, gets the + completions, then calls :meth:`format_completion` for each + completion. + """ + args, incomplete = self.get_completion_args() + completions = self.get_completions(args, incomplete) + out = [self.format_completion(item) for item in completions] + return "\n".join(out) + + +class BashComplete(ShellComplete): + """Shell completion for Bash.""" + + name = "bash" + source_template = _SOURCE_BASH + + @staticmethod + def _check_version() -> None: + import shutil + import subprocess + + bash_exe = shutil.which("bash") + + if bash_exe is None: + match = None + else: + output = subprocess.run( + [bash_exe, "--norc", "-c", 'echo "${BASH_VERSION}"'], + stdout=subprocess.PIPE, + ) + match = re.search(r"^(\d+)\.(\d+)\.\d+", output.stdout.decode()) + + if match is not None: + major, minor = match.groups() + + if major < "4" or major == "4" and minor < "4": + echo( + _( + "Shell completion is not supported for Bash" + " versions older than 4.4." + ), + err=True, + ) + else: + echo( + _("Couldn't detect Bash version, shell completion is not supported."), + err=True, + ) + + def source(self) -> str: + self._check_version() + return super().source() + + def get_completion_args(self) -> t.Tuple[t.List[str], str]: + cwords = split_arg_string(os.environ["COMP_WORDS"]) + cword = int(os.environ["COMP_CWORD"]) + args = cwords[1:cword] + + try: + incomplete = cwords[cword] + except IndexError: + incomplete = "" + + return args, incomplete + + def format_completion(self, item: CompletionItem) -> str: + return f"{item.type},{item.value}" + + +class ZshComplete(ShellComplete): + """Shell completion for Zsh.""" + + name = "zsh" + source_template = _SOURCE_ZSH + + def get_completion_args(self) -> t.Tuple[t.List[str], str]: + cwords = split_arg_string(os.environ["COMP_WORDS"]) + cword = int(os.environ["COMP_CWORD"]) + args = cwords[1:cword] + + try: + incomplete = cwords[cword] + except IndexError: + incomplete = "" + + return args, incomplete + + def format_completion(self, item: CompletionItem) -> str: + return f"{item.type}\n{item.value}\n{item.help if item.help else '_'}" + + +class FishComplete(ShellComplete): + """Shell completion for Fish.""" + + name = "fish" + source_template = _SOURCE_FISH + + def get_completion_args(self) -> t.Tuple[t.List[str], str]: + cwords = split_arg_string(os.environ["COMP_WORDS"]) + incomplete = os.environ["COMP_CWORD"] + args = cwords[1:] + + # Fish stores the partial word in both COMP_WORDS and + # COMP_CWORD, remove it from complete args. + if incomplete and args and args[-1] == incomplete: + args.pop() + + return args, incomplete + + def format_completion(self, item: CompletionItem) -> str: + if item.help: + return f"{item.type},{item.value}\t{item.help}" + + return f"{item.type},{item.value}" + + +ShellCompleteType = t.TypeVar("ShellCompleteType", bound=t.Type[ShellComplete]) + + +_available_shells: t.Dict[str, t.Type[ShellComplete]] = { + "bash": BashComplete, + "fish": FishComplete, + "zsh": ZshComplete, +} + + +def add_completion_class( + cls: ShellCompleteType, name: t.Optional[str] = None +) -> ShellCompleteType: + """Register a :class:`ShellComplete` subclass under the given name. + The name will be provided by the completion instruction environment + variable during completion. + + :param cls: The completion class that will handle completion for the + shell. + :param name: Name to register the class under. Defaults to the + class's ``name`` attribute. + """ + if name is None: + name = cls.name + + _available_shells[name] = cls + + return cls + + +def get_completion_class(shell: str) -> t.Optional[t.Type[ShellComplete]]: + """Look up a registered :class:`ShellComplete` subclass by the name + provided by the completion instruction environment variable. If the + name isn't registered, returns ``None``. + + :param shell: Name the class is registered under. + """ + return _available_shells.get(shell) + + +def _is_incomplete_argument(ctx: Context, param: Parameter) -> bool: + """Determine if the given parameter is an argument that can still + accept values. + + :param ctx: Invocation context for the command represented by the + parsed complete args. + :param param: Argument object being checked. + """ + if not isinstance(param, Argument): + return False + + assert param.name is not None + # Will be None if expose_value is False. + value = ctx.params.get(param.name) + return ( + param.nargs == -1 + or ctx.get_parameter_source(param.name) is not ParameterSource.COMMANDLINE + or ( + param.nargs > 1 + and isinstance(value, (tuple, list)) + and len(value) < param.nargs + ) + ) + + +def _start_of_option(ctx: Context, value: str) -> bool: + """Check if the value looks like the start of an option.""" + if not value: + return False + + c = value[0] + return c in ctx._opt_prefixes + + +def _is_incomplete_option(ctx: Context, args: t.List[str], param: Parameter) -> bool: + """Determine if the given parameter is an option that needs a value. + + :param args: List of complete args before the incomplete value. + :param param: Option object being checked. + """ + if not isinstance(param, Option): + return False + + if param.is_flag or param.count: + return False + + last_option = None + + for index, arg in enumerate(reversed(args)): + if index + 1 > param.nargs: + break + + if _start_of_option(ctx, arg): + last_option = arg + + return last_option is not None and last_option in param.opts + + +def _resolve_context( + cli: BaseCommand, + ctx_args: t.MutableMapping[str, t.Any], + prog_name: str, + args: t.List[str], +) -> Context: + """Produce the context hierarchy starting with the command and + traversing the complete arguments. This only follows the commands, + it doesn't trigger input prompts or callbacks. + + :param cli: Command being called. + :param prog_name: Name of the executable in the shell. + :param args: List of complete args before the incomplete value. + """ + ctx_args["resilient_parsing"] = True + ctx = cli.make_context(prog_name, args.copy(), **ctx_args) + args = ctx.protected_args + ctx.args + + while args: + command = ctx.command + + if isinstance(command, MultiCommand): + if not command.chain: + name, cmd, args = command.resolve_command(ctx, args) + + if cmd is None: + return ctx + + ctx = cmd.make_context(name, args, parent=ctx, resilient_parsing=True) + args = ctx.protected_args + ctx.args + else: + sub_ctx = ctx + + while args: + name, cmd, args = command.resolve_command(ctx, args) + + if cmd is None: + return ctx + + sub_ctx = cmd.make_context( + name, + args, + parent=ctx, + allow_extra_args=True, + allow_interspersed_args=False, + resilient_parsing=True, + ) + args = sub_ctx.args + + ctx = sub_ctx + args = [*sub_ctx.protected_args, *sub_ctx.args] + else: + break + + return ctx + + +def _resolve_incomplete( + ctx: Context, args: t.List[str], incomplete: str +) -> t.Tuple[t.Union[BaseCommand, Parameter], str]: + """Find the Click object that will handle the completion of the + incomplete value. Return the object and the incomplete value. + + :param ctx: Invocation context for the command represented by + the parsed complete args. + :param args: List of complete args before the incomplete value. + :param incomplete: Value being completed. May be empty. + """ + # Different shells treat an "=" between a long option name and + # value differently. Might keep the value joined, return the "=" + # as a separate item, or return the split name and value. Always + # split and discard the "=" to make completion easier. + if incomplete == "=": + incomplete = "" + elif "=" in incomplete and _start_of_option(ctx, incomplete): + name, _, incomplete = incomplete.partition("=") + args.append(name) + + # The "--" marker tells Click to stop treating values as options + # even if they start with the option character. If it hasn't been + # given and the incomplete arg looks like an option, the current + # command will provide option name completions. + if "--" not in args and _start_of_option(ctx, incomplete): + return ctx.command, incomplete + + params = ctx.command.get_params(ctx) + + # If the last complete arg is an option name with an incomplete + # value, the option will provide value completions. + for param in params: + if _is_incomplete_option(ctx, args, param): + return param, incomplete + + # It's not an option name or value. The first argument without a + # parsed value will provide value completions. + for param in params: + if _is_incomplete_argument(ctx, param): + return param, incomplete + + # There were no unparsed arguments, the command may be a group that + # will provide command name completions. + return ctx.command, incomplete diff --git a/.venv/Lib/site-packages/click/termui.py b/.venv/Lib/site-packages/click/termui.py new file mode 100644 index 0000000..c084f19 --- /dev/null +++ b/.venv/Lib/site-packages/click/termui.py @@ -0,0 +1,784 @@ +import inspect +import io +import itertools +import sys +import typing as t +from gettext import gettext as _ + +from ._compat import isatty +from ._compat import strip_ansi +from .exceptions import Abort +from .exceptions import UsageError +from .globals import resolve_color_default +from .types import Choice +from .types import convert_type +from .types import ParamType +from .utils import echo +from .utils import LazyFile + +if t.TYPE_CHECKING: + from ._termui_impl import ProgressBar + +V = t.TypeVar("V") + +# The prompt functions to use. The doc tools currently override these +# functions to customize how they work. +visible_prompt_func: t.Callable[[str], str] = input + +_ansi_colors = { + "black": 30, + "red": 31, + "green": 32, + "yellow": 33, + "blue": 34, + "magenta": 35, + "cyan": 36, + "white": 37, + "reset": 39, + "bright_black": 90, + "bright_red": 91, + "bright_green": 92, + "bright_yellow": 93, + "bright_blue": 94, + "bright_magenta": 95, + "bright_cyan": 96, + "bright_white": 97, +} +_ansi_reset_all = "\033[0m" + + +def hidden_prompt_func(prompt: str) -> str: + import getpass + + return getpass.getpass(prompt) + + +def _build_prompt( + text: str, + suffix: str, + show_default: bool = False, + default: t.Optional[t.Any] = None, + show_choices: bool = True, + type: t.Optional[ParamType] = None, +) -> str: + prompt = text + if type is not None and show_choices and isinstance(type, Choice): + prompt += f" ({', '.join(map(str, type.choices))})" + if default is not None and show_default: + prompt = f"{prompt} [{_format_default(default)}]" + return f"{prompt}{suffix}" + + +def _format_default(default: t.Any) -> t.Any: + if isinstance(default, (io.IOBase, LazyFile)) and hasattr(default, "name"): + return default.name + + return default + + +def prompt( + text: str, + default: t.Optional[t.Any] = None, + hide_input: bool = False, + confirmation_prompt: t.Union[bool, str] = False, + type: t.Optional[t.Union[ParamType, t.Any]] = None, + value_proc: t.Optional[t.Callable[[str], t.Any]] = None, + prompt_suffix: str = ": ", + show_default: bool = True, + err: bool = False, + show_choices: bool = True, +) -> t.Any: + """Prompts a user for input. This is a convenience function that can + be used to prompt a user for input later. + + If the user aborts the input by sending an interrupt signal, this + function will catch it and raise a :exc:`Abort` exception. + + :param text: the text to show for the prompt. + :param default: the default value to use if no input happens. If this + is not given it will prompt until it's aborted. + :param hide_input: if this is set to true then the input value will + be hidden. + :param confirmation_prompt: Prompt a second time to confirm the + value. Can be set to a string instead of ``True`` to customize + the message. + :param type: the type to use to check the value against. + :param value_proc: if this parameter is provided it's a function that + is invoked instead of the type conversion to + convert a value. + :param prompt_suffix: a suffix that should be added to the prompt. + :param show_default: shows or hides the default value in the prompt. + :param err: if set to true the file defaults to ``stderr`` instead of + ``stdout``, the same as with echo. + :param show_choices: Show or hide choices if the passed type is a Choice. + For example if type is a Choice of either day or week, + show_choices is true and text is "Group by" then the + prompt will be "Group by (day, week): ". + + .. versionadded:: 8.0 + ``confirmation_prompt`` can be a custom string. + + .. versionadded:: 7.0 + Added the ``show_choices`` parameter. + + .. versionadded:: 6.0 + Added unicode support for cmd.exe on Windows. + + .. versionadded:: 4.0 + Added the `err` parameter. + + """ + + def prompt_func(text: str) -> str: + f = hidden_prompt_func if hide_input else visible_prompt_func + try: + # Write the prompt separately so that we get nice + # coloring through colorama on Windows + echo(text.rstrip(" "), nl=False, err=err) + # Echo a space to stdout to work around an issue where + # readline causes backspace to clear the whole line. + return f(" ") + except (KeyboardInterrupt, EOFError): + # getpass doesn't print a newline if the user aborts input with ^C. + # Allegedly this behavior is inherited from getpass(3). + # A doc bug has been filed at https://bugs.python.org/issue24711 + if hide_input: + echo(None, err=err) + raise Abort() from None + + if value_proc is None: + value_proc = convert_type(type, default) + + prompt = _build_prompt( + text, prompt_suffix, show_default, default, show_choices, type + ) + + if confirmation_prompt: + if confirmation_prompt is True: + confirmation_prompt = _("Repeat for confirmation") + + confirmation_prompt = _build_prompt(confirmation_prompt, prompt_suffix) + + while True: + while True: + value = prompt_func(prompt) + if value: + break + elif default is not None: + value = default + break + try: + result = value_proc(value) + except UsageError as e: + if hide_input: + echo(_("Error: The value you entered was invalid."), err=err) + else: + echo(_("Error: {e.message}").format(e=e), err=err) + continue + if not confirmation_prompt: + return result + while True: + value2 = prompt_func(confirmation_prompt) + is_empty = not value and not value2 + if value2 or is_empty: + break + if value == value2: + return result + echo(_("Error: The two entered values do not match."), err=err) + + +def confirm( + text: str, + default: t.Optional[bool] = False, + abort: bool = False, + prompt_suffix: str = ": ", + show_default: bool = True, + err: bool = False, +) -> bool: + """Prompts for confirmation (yes/no question). + + If the user aborts the input by sending a interrupt signal this + function will catch it and raise a :exc:`Abort` exception. + + :param text: the question to ask. + :param default: The default value to use when no input is given. If + ``None``, repeat until input is given. + :param abort: if this is set to `True` a negative answer aborts the + exception by raising :exc:`Abort`. + :param prompt_suffix: a suffix that should be added to the prompt. + :param show_default: shows or hides the default value in the prompt. + :param err: if set to true the file defaults to ``stderr`` instead of + ``stdout``, the same as with echo. + + .. versionchanged:: 8.0 + Repeat until input is given if ``default`` is ``None``. + + .. versionadded:: 4.0 + Added the ``err`` parameter. + """ + prompt = _build_prompt( + text, + prompt_suffix, + show_default, + "y/n" if default is None else ("Y/n" if default else "y/N"), + ) + + while True: + try: + # Write the prompt separately so that we get nice + # coloring through colorama on Windows + echo(prompt.rstrip(" "), nl=False, err=err) + # Echo a space to stdout to work around an issue where + # readline causes backspace to clear the whole line. + value = visible_prompt_func(" ").lower().strip() + except (KeyboardInterrupt, EOFError): + raise Abort() from None + if value in ("y", "yes"): + rv = True + elif value in ("n", "no"): + rv = False + elif default is not None and value == "": + rv = default + else: + echo(_("Error: invalid input"), err=err) + continue + break + if abort and not rv: + raise Abort() + return rv + + +def echo_via_pager( + text_or_generator: t.Union[t.Iterable[str], t.Callable[[], t.Iterable[str]], str], + color: t.Optional[bool] = None, +) -> None: + """This function takes a text and shows it via an environment specific + pager on stdout. + + .. versionchanged:: 3.0 + Added the `color` flag. + + :param text_or_generator: the text to page, or alternatively, a + generator emitting the text to page. + :param color: controls if the pager supports ANSI colors or not. The + default is autodetection. + """ + color = resolve_color_default(color) + + if inspect.isgeneratorfunction(text_or_generator): + i = t.cast(t.Callable[[], t.Iterable[str]], text_or_generator)() + elif isinstance(text_or_generator, str): + i = [text_or_generator] + else: + i = iter(t.cast(t.Iterable[str], text_or_generator)) + + # convert every element of i to a text type if necessary + text_generator = (el if isinstance(el, str) else str(el) for el in i) + + from ._termui_impl import pager + + return pager(itertools.chain(text_generator, "\n"), color) + + +def progressbar( + iterable: t.Optional[t.Iterable[V]] = None, + length: t.Optional[int] = None, + label: t.Optional[str] = None, + show_eta: bool = True, + show_percent: t.Optional[bool] = None, + show_pos: bool = False, + item_show_func: t.Optional[t.Callable[[t.Optional[V]], t.Optional[str]]] = None, + fill_char: str = "#", + empty_char: str = "-", + bar_template: str = "%(label)s [%(bar)s] %(info)s", + info_sep: str = " ", + width: int = 36, + file: t.Optional[t.TextIO] = None, + color: t.Optional[bool] = None, + update_min_steps: int = 1, +) -> "ProgressBar[V]": + """This function creates an iterable context manager that can be used + to iterate over something while showing a progress bar. It will + either iterate over the `iterable` or `length` items (that are counted + up). While iteration happens, this function will print a rendered + progress bar to the given `file` (defaults to stdout) and will attempt + to calculate remaining time and more. By default, this progress bar + will not be rendered if the file is not a terminal. + + The context manager creates the progress bar. When the context + manager is entered the progress bar is already created. With every + iteration over the progress bar, the iterable passed to the bar is + advanced and the bar is updated. When the context manager exits, + a newline is printed and the progress bar is finalized on screen. + + Note: The progress bar is currently designed for use cases where the + total progress can be expected to take at least several seconds. + Because of this, the ProgressBar class object won't display + progress that is considered too fast, and progress where the time + between steps is less than a second. + + No printing must happen or the progress bar will be unintentionally + destroyed. + + Example usage:: + + with progressbar(items) as bar: + for item in bar: + do_something_with(item) + + Alternatively, if no iterable is specified, one can manually update the + progress bar through the `update()` method instead of directly + iterating over the progress bar. The update method accepts the number + of steps to increment the bar with:: + + with progressbar(length=chunks.total_bytes) as bar: + for chunk in chunks: + process_chunk(chunk) + bar.update(chunks.bytes) + + The ``update()`` method also takes an optional value specifying the + ``current_item`` at the new position. This is useful when used + together with ``item_show_func`` to customize the output for each + manual step:: + + with click.progressbar( + length=total_size, + label='Unzipping archive', + item_show_func=lambda a: a.filename + ) as bar: + for archive in zip_file: + archive.extract() + bar.update(archive.size, archive) + + :param iterable: an iterable to iterate over. If not provided the length + is required. + :param length: the number of items to iterate over. By default the + progressbar will attempt to ask the iterator about its + length, which might or might not work. If an iterable is + also provided this parameter can be used to override the + length. If an iterable is not provided the progress bar + will iterate over a range of that length. + :param label: the label to show next to the progress bar. + :param show_eta: enables or disables the estimated time display. This is + automatically disabled if the length cannot be + determined. + :param show_percent: enables or disables the percentage display. The + default is `True` if the iterable has a length or + `False` if not. + :param show_pos: enables or disables the absolute position display. The + default is `False`. + :param item_show_func: A function called with the current item which + can return a string to show next to the progress bar. If the + function returns ``None`` nothing is shown. The current item can + be ``None``, such as when entering and exiting the bar. + :param fill_char: the character to use to show the filled part of the + progress bar. + :param empty_char: the character to use to show the non-filled part of + the progress bar. + :param bar_template: the format string to use as template for the bar. + The parameters in it are ``label`` for the label, + ``bar`` for the progress bar and ``info`` for the + info section. + :param info_sep: the separator between multiple info items (eta etc.) + :param width: the width of the progress bar in characters, 0 means full + terminal width + :param file: The file to write to. If this is not a terminal then + only the label is printed. + :param color: controls if the terminal supports ANSI colors or not. The + default is autodetection. This is only needed if ANSI + codes are included anywhere in the progress bar output + which is not the case by default. + :param update_min_steps: Render only when this many updates have + completed. This allows tuning for very fast iterators. + + .. versionchanged:: 8.0 + Output is shown even if execution time is less than 0.5 seconds. + + .. versionchanged:: 8.0 + ``item_show_func`` shows the current item, not the previous one. + + .. versionchanged:: 8.0 + Labels are echoed if the output is not a TTY. Reverts a change + in 7.0 that removed all output. + + .. versionadded:: 8.0 + Added the ``update_min_steps`` parameter. + + .. versionchanged:: 4.0 + Added the ``color`` parameter. Added the ``update`` method to + the object. + + .. versionadded:: 2.0 + """ + from ._termui_impl import ProgressBar + + color = resolve_color_default(color) + return ProgressBar( + iterable=iterable, + length=length, + show_eta=show_eta, + show_percent=show_percent, + show_pos=show_pos, + item_show_func=item_show_func, + fill_char=fill_char, + empty_char=empty_char, + bar_template=bar_template, + info_sep=info_sep, + file=file, + label=label, + width=width, + color=color, + update_min_steps=update_min_steps, + ) + + +def clear() -> None: + """Clears the terminal screen. This will have the effect of clearing + the whole visible space of the terminal and moving the cursor to the + top left. This does not do anything if not connected to a terminal. + + .. versionadded:: 2.0 + """ + if not isatty(sys.stdout): + return + + # ANSI escape \033[2J clears the screen, \033[1;1H moves the cursor + echo("\033[2J\033[1;1H", nl=False) + + +def _interpret_color( + color: t.Union[int, t.Tuple[int, int, int], str], offset: int = 0 +) -> str: + if isinstance(color, int): + return f"{38 + offset};5;{color:d}" + + if isinstance(color, (tuple, list)): + r, g, b = color + return f"{38 + offset};2;{r:d};{g:d};{b:d}" + + return str(_ansi_colors[color] + offset) + + +def style( + text: t.Any, + fg: t.Optional[t.Union[int, t.Tuple[int, int, int], str]] = None, + bg: t.Optional[t.Union[int, t.Tuple[int, int, int], str]] = None, + bold: t.Optional[bool] = None, + dim: t.Optional[bool] = None, + underline: t.Optional[bool] = None, + overline: t.Optional[bool] = None, + italic: t.Optional[bool] = None, + blink: t.Optional[bool] = None, + reverse: t.Optional[bool] = None, + strikethrough: t.Optional[bool] = None, + reset: bool = True, +) -> str: + """Styles a text with ANSI styles and returns the new string. By + default the styling is self contained which means that at the end + of the string a reset code is issued. This can be prevented by + passing ``reset=False``. + + Examples:: + + click.echo(click.style('Hello World!', fg='green')) + click.echo(click.style('ATTENTION!', blink=True)) + click.echo(click.style('Some things', reverse=True, fg='cyan')) + click.echo(click.style('More colors', fg=(255, 12, 128), bg=117)) + + Supported color names: + + * ``black`` (might be a gray) + * ``red`` + * ``green`` + * ``yellow`` (might be an orange) + * ``blue`` + * ``magenta`` + * ``cyan`` + * ``white`` (might be light gray) + * ``bright_black`` + * ``bright_red`` + * ``bright_green`` + * ``bright_yellow`` + * ``bright_blue`` + * ``bright_magenta`` + * ``bright_cyan`` + * ``bright_white`` + * ``reset`` (reset the color code only) + + If the terminal supports it, color may also be specified as: + + - An integer in the interval [0, 255]. The terminal must support + 8-bit/256-color mode. + - An RGB tuple of three integers in [0, 255]. The terminal must + support 24-bit/true-color mode. + + See https://en.wikipedia.org/wiki/ANSI_color and + https://gist.github.com/XVilka/8346728 for more information. + + :param text: the string to style with ansi codes. + :param fg: if provided this will become the foreground color. + :param bg: if provided this will become the background color. + :param bold: if provided this will enable or disable bold mode. + :param dim: if provided this will enable or disable dim mode. This is + badly supported. + :param underline: if provided this will enable or disable underline. + :param overline: if provided this will enable or disable overline. + :param italic: if provided this will enable or disable italic. + :param blink: if provided this will enable or disable blinking. + :param reverse: if provided this will enable or disable inverse + rendering (foreground becomes background and the + other way round). + :param strikethrough: if provided this will enable or disable + striking through text. + :param reset: by default a reset-all code is added at the end of the + string which means that styles do not carry over. This + can be disabled to compose styles. + + .. versionchanged:: 8.0 + A non-string ``message`` is converted to a string. + + .. versionchanged:: 8.0 + Added support for 256 and RGB color codes. + + .. versionchanged:: 8.0 + Added the ``strikethrough``, ``italic``, and ``overline`` + parameters. + + .. versionchanged:: 7.0 + Added support for bright colors. + + .. versionadded:: 2.0 + """ + if not isinstance(text, str): + text = str(text) + + bits = [] + + if fg: + try: + bits.append(f"\033[{_interpret_color(fg)}m") + except KeyError: + raise TypeError(f"Unknown color {fg!r}") from None + + if bg: + try: + bits.append(f"\033[{_interpret_color(bg, 10)}m") + except KeyError: + raise TypeError(f"Unknown color {bg!r}") from None + + if bold is not None: + bits.append(f"\033[{1 if bold else 22}m") + if dim is not None: + bits.append(f"\033[{2 if dim else 22}m") + if underline is not None: + bits.append(f"\033[{4 if underline else 24}m") + if overline is not None: + bits.append(f"\033[{53 if overline else 55}m") + if italic is not None: + bits.append(f"\033[{3 if italic else 23}m") + if blink is not None: + bits.append(f"\033[{5 if blink else 25}m") + if reverse is not None: + bits.append(f"\033[{7 if reverse else 27}m") + if strikethrough is not None: + bits.append(f"\033[{9 if strikethrough else 29}m") + bits.append(text) + if reset: + bits.append(_ansi_reset_all) + return "".join(bits) + + +def unstyle(text: str) -> str: + """Removes ANSI styling information from a string. Usually it's not + necessary to use this function as Click's echo function will + automatically remove styling if necessary. + + .. versionadded:: 2.0 + + :param text: the text to remove style information from. + """ + return strip_ansi(text) + + +def secho( + message: t.Optional[t.Any] = None, + file: t.Optional[t.IO[t.AnyStr]] = None, + nl: bool = True, + err: bool = False, + color: t.Optional[bool] = None, + **styles: t.Any, +) -> None: + """This function combines :func:`echo` and :func:`style` into one + call. As such the following two calls are the same:: + + click.secho('Hello World!', fg='green') + click.echo(click.style('Hello World!', fg='green')) + + All keyword arguments are forwarded to the underlying functions + depending on which one they go with. + + Non-string types will be converted to :class:`str`. However, + :class:`bytes` are passed directly to :meth:`echo` without applying + style. If you want to style bytes that represent text, call + :meth:`bytes.decode` first. + + .. versionchanged:: 8.0 + A non-string ``message`` is converted to a string. Bytes are + passed through without style applied. + + .. versionadded:: 2.0 + """ + if message is not None and not isinstance(message, (bytes, bytearray)): + message = style(message, **styles) + + return echo(message, file=file, nl=nl, err=err, color=color) + + +def edit( + text: t.Optional[t.AnyStr] = None, + editor: t.Optional[str] = None, + env: t.Optional[t.Mapping[str, str]] = None, + require_save: bool = True, + extension: str = ".txt", + filename: t.Optional[str] = None, +) -> t.Optional[t.AnyStr]: + r"""Edits the given text in the defined editor. If an editor is given + (should be the full path to the executable but the regular operating + system search path is used for finding the executable) it overrides + the detected editor. Optionally, some environment variables can be + used. If the editor is closed without changes, `None` is returned. In + case a file is edited directly the return value is always `None` and + `require_save` and `extension` are ignored. + + If the editor cannot be opened a :exc:`UsageError` is raised. + + Note for Windows: to simplify cross-platform usage, the newlines are + automatically converted from POSIX to Windows and vice versa. As such, + the message here will have ``\n`` as newline markers. + + :param text: the text to edit. + :param editor: optionally the editor to use. Defaults to automatic + detection. + :param env: environment variables to forward to the editor. + :param require_save: if this is true, then not saving in the editor + will make the return value become `None`. + :param extension: the extension to tell the editor about. This defaults + to `.txt` but changing this might change syntax + highlighting. + :param filename: if provided it will edit this file instead of the + provided text contents. It will not use a temporary + file as an indirection in that case. + """ + from ._termui_impl import Editor + + ed = Editor(editor=editor, env=env, require_save=require_save, extension=extension) + + if filename is None: + return ed.edit(text) + + ed.edit_file(filename) + return None + + +def launch(url: str, wait: bool = False, locate: bool = False) -> int: + """This function launches the given URL (or filename) in the default + viewer application for this file type. If this is an executable, it + might launch the executable in a new session. The return value is + the exit code of the launched application. Usually, ``0`` indicates + success. + + Examples:: + + click.launch('https://click.palletsprojects.com/') + click.launch('/my/downloaded/file', locate=True) + + .. versionadded:: 2.0 + + :param url: URL or filename of the thing to launch. + :param wait: Wait for the program to exit before returning. This + only works if the launched program blocks. In particular, + ``xdg-open`` on Linux does not block. + :param locate: if this is set to `True` then instead of launching the + application associated with the URL it will attempt to + launch a file manager with the file located. This + might have weird effects if the URL does not point to + the filesystem. + """ + from ._termui_impl import open_url + + return open_url(url, wait=wait, locate=locate) + + +# If this is provided, getchar() calls into this instead. This is used +# for unittesting purposes. +_getchar: t.Optional[t.Callable[[bool], str]] = None + + +def getchar(echo: bool = False) -> str: + """Fetches a single character from the terminal and returns it. This + will always return a unicode character and under certain rare + circumstances this might return more than one character. The + situations which more than one character is returned is when for + whatever reason multiple characters end up in the terminal buffer or + standard input was not actually a terminal. + + Note that this will always read from the terminal, even if something + is piped into the standard input. + + Note for Windows: in rare cases when typing non-ASCII characters, this + function might wait for a second character and then return both at once. + This is because certain Unicode characters look like special-key markers. + + .. versionadded:: 2.0 + + :param echo: if set to `True`, the character read will also show up on + the terminal. The default is to not show it. + """ + global _getchar + + if _getchar is None: + from ._termui_impl import getchar as f + + _getchar = f + + return _getchar(echo) + + +def raw_terminal() -> t.ContextManager[int]: + from ._termui_impl import raw_terminal as f + + return f() + + +def pause(info: t.Optional[str] = None, err: bool = False) -> None: + """This command stops execution and waits for the user to press any + key to continue. This is similar to the Windows batch "pause" + command. If the program is not run through a terminal, this command + will instead do nothing. + + .. versionadded:: 2.0 + + .. versionadded:: 4.0 + Added the `err` parameter. + + :param info: The message to print before pausing. Defaults to + ``"Press any key to continue..."``. + :param err: if set to message goes to ``stderr`` instead of + ``stdout``, the same as with echo. + """ + if not isatty(sys.stdin) or not isatty(sys.stdout): + return + + if info is None: + info = _("Press any key to continue...") + + try: + if info: + echo(info, nl=False, err=err) + try: + getchar() + except (KeyboardInterrupt, EOFError): + pass + finally: + if info: + echo(err=err) diff --git a/.venv/Lib/site-packages/click/testing.py b/.venv/Lib/site-packages/click/testing.py new file mode 100644 index 0000000..772b215 --- /dev/null +++ b/.venv/Lib/site-packages/click/testing.py @@ -0,0 +1,483 @@ +import contextlib +import io +import os +import shlex +import shutil +import sys +import tempfile +import typing as t +from types import TracebackType + +from . import _compat +from . import formatting +from . import termui +from . import utils +from ._compat import _find_binary_reader + +if t.TYPE_CHECKING: + from .core import BaseCommand + + +class EchoingStdin: + def __init__(self, input: t.BinaryIO, output: t.BinaryIO) -> None: + self._input = input + self._output = output + self._paused = False + + def __getattr__(self, x: str) -> t.Any: + return getattr(self._input, x) + + def _echo(self, rv: bytes) -> bytes: + if not self._paused: + self._output.write(rv) + + return rv + + def read(self, n: int = -1) -> bytes: + return self._echo(self._input.read(n)) + + def read1(self, n: int = -1) -> bytes: + return self._echo(self._input.read1(n)) # type: ignore + + def readline(self, n: int = -1) -> bytes: + return self._echo(self._input.readline(n)) + + def readlines(self) -> t.List[bytes]: + return [self._echo(x) for x in self._input.readlines()] + + def __iter__(self) -> t.Iterator[bytes]: + return iter(self._echo(x) for x in self._input) + + def __repr__(self) -> str: + return repr(self._input) + + +@contextlib.contextmanager +def _pause_echo(stream: t.Optional[EchoingStdin]) -> t.Iterator[None]: + if stream is None: + yield + else: + stream._paused = True + yield + stream._paused = False + + +class _NamedTextIOWrapper(io.TextIOWrapper): + def __init__( + self, buffer: t.BinaryIO, name: str, mode: str, **kwargs: t.Any + ) -> None: + super().__init__(buffer, **kwargs) + self._name = name + self._mode = mode + + @property + def name(self) -> str: + return self._name + + @property + def mode(self) -> str: + return self._mode + + +def make_input_stream( + input: t.Optional[t.Union[str, bytes, t.IO[t.Any]]], charset: str +) -> t.BinaryIO: + # Is already an input stream. + if hasattr(input, "read"): + rv = _find_binary_reader(t.cast(t.IO[t.Any], input)) + + if rv is not None: + return rv + + raise TypeError("Could not find binary reader for input stream.") + + if input is None: + input = b"" + elif isinstance(input, str): + input = input.encode(charset) + + return io.BytesIO(input) + + +class Result: + """Holds the captured result of an invoked CLI script.""" + + def __init__( + self, + runner: "CliRunner", + stdout_bytes: bytes, + stderr_bytes: t.Optional[bytes], + return_value: t.Any, + exit_code: int, + exception: t.Optional[BaseException], + exc_info: t.Optional[ + t.Tuple[t.Type[BaseException], BaseException, TracebackType] + ] = None, + ): + #: The runner that created the result + self.runner = runner + #: The standard output as bytes. + self.stdout_bytes = stdout_bytes + #: The standard error as bytes, or None if not available + self.stderr_bytes = stderr_bytes + #: The value returned from the invoked command. + #: + #: .. versionadded:: 8.0 + self.return_value = return_value + #: The exit code as integer. + self.exit_code = exit_code + #: The exception that happened if one did. + self.exception = exception + #: The traceback + self.exc_info = exc_info + + @property + def output(self) -> str: + """The (standard) output as unicode string.""" + return self.stdout + + @property + def stdout(self) -> str: + """The standard output as unicode string.""" + return self.stdout_bytes.decode(self.runner.charset, "replace").replace( + "\r\n", "\n" + ) + + @property + def stderr(self) -> str: + """The standard error as unicode string.""" + if self.stderr_bytes is None: + raise ValueError("stderr not separately captured") + return self.stderr_bytes.decode(self.runner.charset, "replace").replace( + "\r\n", "\n" + ) + + def __repr__(self) -> str: + exc_str = repr(self.exception) if self.exception else "okay" + return f"<{type(self).__name__} {exc_str}>" + + +class CliRunner: + """The CLI runner provides functionality to invoke a Click command line + script for unittesting purposes in a isolated environment. This only + works in single-threaded systems without any concurrency as it changes the + global interpreter state. + + :param charset: the character set for the input and output data. + :param env: a dictionary with environment variables for overriding. + :param echo_stdin: if this is set to `True`, then reading from stdin writes + to stdout. This is useful for showing examples in + some circumstances. Note that regular prompts + will automatically echo the input. + :param mix_stderr: if this is set to `False`, then stdout and stderr are + preserved as independent streams. This is useful for + Unix-philosophy apps that have predictable stdout and + noisy stderr, such that each may be measured + independently + """ + + def __init__( + self, + charset: str = "utf-8", + env: t.Optional[t.Mapping[str, t.Optional[str]]] = None, + echo_stdin: bool = False, + mix_stderr: bool = True, + ) -> None: + self.charset = charset + self.env: t.Mapping[str, t.Optional[str]] = env or {} + self.echo_stdin = echo_stdin + self.mix_stderr = mix_stderr + + def get_default_prog_name(self, cli: "BaseCommand") -> str: + """Given a command object it will return the default program name + for it. The default is the `name` attribute or ``"root"`` if not + set. + """ + return cli.name or "root" + + def make_env( + self, overrides: t.Optional[t.Mapping[str, t.Optional[str]]] = None + ) -> t.Mapping[str, t.Optional[str]]: + """Returns the environment overrides for invoking a script.""" + rv = dict(self.env) + if overrides: + rv.update(overrides) + return rv + + @contextlib.contextmanager + def isolation( + self, + input: t.Optional[t.Union[str, bytes, t.IO[t.Any]]] = None, + env: t.Optional[t.Mapping[str, t.Optional[str]]] = None, + color: bool = False, + ) -> t.Iterator[t.Tuple[io.BytesIO, t.Optional[io.BytesIO]]]: + """A context manager that sets up the isolation for invoking of a + command line tool. This sets up stdin with the given input data + and `os.environ` with the overrides from the given dictionary. + This also rebinds some internals in Click to be mocked (like the + prompt functionality). + + This is automatically done in the :meth:`invoke` method. + + :param input: the input stream to put into sys.stdin. + :param env: the environment overrides as dictionary. + :param color: whether the output should contain color codes. The + application can still override this explicitly. + + .. versionchanged:: 8.0 + ``stderr`` is opened with ``errors="backslashreplace"`` + instead of the default ``"strict"``. + + .. versionchanged:: 4.0 + Added the ``color`` parameter. + """ + bytes_input = make_input_stream(input, self.charset) + echo_input = None + + old_stdin = sys.stdin + old_stdout = sys.stdout + old_stderr = sys.stderr + old_forced_width = formatting.FORCED_WIDTH + formatting.FORCED_WIDTH = 80 + + env = self.make_env(env) + + bytes_output = io.BytesIO() + + if self.echo_stdin: + bytes_input = echo_input = t.cast( + t.BinaryIO, EchoingStdin(bytes_input, bytes_output) + ) + + sys.stdin = text_input = _NamedTextIOWrapper( + bytes_input, encoding=self.charset, name="", mode="r" + ) + + if self.echo_stdin: + # Force unbuffered reads, otherwise TextIOWrapper reads a + # large chunk which is echoed early. + text_input._CHUNK_SIZE = 1 # type: ignore + + sys.stdout = _NamedTextIOWrapper( + bytes_output, encoding=self.charset, name="", mode="w" + ) + + bytes_error = None + if self.mix_stderr: + sys.stderr = sys.stdout + else: + bytes_error = io.BytesIO() + sys.stderr = _NamedTextIOWrapper( + bytes_error, + encoding=self.charset, + name="", + mode="w", + errors="backslashreplace", + ) + + @_pause_echo(echo_input) # type: ignore + def visible_input(prompt: t.Optional[str] = None) -> str: + sys.stdout.write(prompt or "") + val = text_input.readline().rstrip("\r\n") + sys.stdout.write(f"{val}\n") + sys.stdout.flush() + return val + + @_pause_echo(echo_input) # type: ignore + def hidden_input(prompt: t.Optional[str] = None) -> str: + sys.stdout.write(f"{prompt or ''}\n") + sys.stdout.flush() + return text_input.readline().rstrip("\r\n") + + @_pause_echo(echo_input) # type: ignore + def _getchar(echo: bool) -> str: + char = sys.stdin.read(1) + + if echo: + sys.stdout.write(char) + + sys.stdout.flush() + return char + + default_color = color + + def should_strip_ansi( + stream: t.Optional[t.IO[t.Any]] = None, color: t.Optional[bool] = None + ) -> bool: + if color is None: + return not default_color + return not color + + old_visible_prompt_func = termui.visible_prompt_func + old_hidden_prompt_func = termui.hidden_prompt_func + old__getchar_func = termui._getchar + old_should_strip_ansi = utils.should_strip_ansi # type: ignore + old__compat_should_strip_ansi = _compat.should_strip_ansi + termui.visible_prompt_func = visible_input + termui.hidden_prompt_func = hidden_input + termui._getchar = _getchar + utils.should_strip_ansi = should_strip_ansi # type: ignore + _compat.should_strip_ansi = should_strip_ansi + + old_env = {} + try: + for key, value in env.items(): + old_env[key] = os.environ.get(key) + if value is None: + try: + del os.environ[key] + except Exception: + pass + else: + os.environ[key] = value + yield (bytes_output, bytes_error) + finally: + for key, value in old_env.items(): + if value is None: + try: + del os.environ[key] + except Exception: + pass + else: + os.environ[key] = value + sys.stdout = old_stdout + sys.stderr = old_stderr + sys.stdin = old_stdin + termui.visible_prompt_func = old_visible_prompt_func + termui.hidden_prompt_func = old_hidden_prompt_func + termui._getchar = old__getchar_func + utils.should_strip_ansi = old_should_strip_ansi # type: ignore + _compat.should_strip_ansi = old__compat_should_strip_ansi + formatting.FORCED_WIDTH = old_forced_width + + def invoke( + self, + cli: "BaseCommand", + args: t.Optional[t.Union[str, t.Sequence[str]]] = None, + input: t.Optional[t.Union[str, bytes, t.IO[t.Any]]] = None, + env: t.Optional[t.Mapping[str, t.Optional[str]]] = None, + catch_exceptions: bool = True, + color: bool = False, + **extra: t.Any, + ) -> Result: + """Invokes a command in an isolated environment. The arguments are + forwarded directly to the command line script, the `extra` keyword + arguments are passed to the :meth:`~clickpkg.Command.main` function of + the command. + + This returns a :class:`Result` object. + + :param cli: the command to invoke + :param args: the arguments to invoke. It may be given as an iterable + or a string. When given as string it will be interpreted + as a Unix shell command. More details at + :func:`shlex.split`. + :param input: the input data for `sys.stdin`. + :param env: the environment overrides. + :param catch_exceptions: Whether to catch any other exceptions than + ``SystemExit``. + :param extra: the keyword arguments to pass to :meth:`main`. + :param color: whether the output should contain color codes. The + application can still override this explicitly. + + .. versionchanged:: 8.0 + The result object has the ``return_value`` attribute with + the value returned from the invoked command. + + .. versionchanged:: 4.0 + Added the ``color`` parameter. + + .. versionchanged:: 3.0 + Added the ``catch_exceptions`` parameter. + + .. versionchanged:: 3.0 + The result object has the ``exc_info`` attribute with the + traceback if available. + """ + exc_info = None + with self.isolation(input=input, env=env, color=color) as outstreams: + return_value = None + exception: t.Optional[BaseException] = None + exit_code = 0 + + if isinstance(args, str): + args = shlex.split(args) + + try: + prog_name = extra.pop("prog_name") + except KeyError: + prog_name = self.get_default_prog_name(cli) + + try: + return_value = cli.main(args=args or (), prog_name=prog_name, **extra) + except SystemExit as e: + exc_info = sys.exc_info() + e_code = t.cast(t.Optional[t.Union[int, t.Any]], e.code) + + if e_code is None: + e_code = 0 + + if e_code != 0: + exception = e + + if not isinstance(e_code, int): + sys.stdout.write(str(e_code)) + sys.stdout.write("\n") + e_code = 1 + + exit_code = e_code + + except Exception as e: + if not catch_exceptions: + raise + exception = e + exit_code = 1 + exc_info = sys.exc_info() + finally: + sys.stdout.flush() + stdout = outstreams[0].getvalue() + if self.mix_stderr: + stderr = None + else: + stderr = outstreams[1].getvalue() # type: ignore + + return Result( + runner=self, + stdout_bytes=stdout, + stderr_bytes=stderr, + return_value=return_value, + exit_code=exit_code, + exception=exception, + exc_info=exc_info, # type: ignore + ) + + @contextlib.contextmanager + def isolated_filesystem( + self, temp_dir: t.Optional[t.Union[str, "os.PathLike[str]"]] = None + ) -> t.Iterator[str]: + """A context manager that creates a temporary directory and + changes the current working directory to it. This isolates tests + that affect the contents of the CWD to prevent them from + interfering with each other. + + :param temp_dir: Create the temporary directory under this + directory. If given, the created directory is not removed + when exiting. + + .. versionchanged:: 8.0 + Added the ``temp_dir`` parameter. + """ + cwd = os.getcwd() + dt = tempfile.mkdtemp(dir=temp_dir) + os.chdir(dt) + + try: + yield dt + finally: + os.chdir(cwd) + + if temp_dir is None: + try: + shutil.rmtree(dt) + except OSError: + pass diff --git a/.venv/Lib/site-packages/click/types.py b/.venv/Lib/site-packages/click/types.py new file mode 100644 index 0000000..a70fd58 --- /dev/null +++ b/.venv/Lib/site-packages/click/types.py @@ -0,0 +1,1093 @@ +import os +import stat +import sys +import typing as t +from datetime import datetime +from gettext import gettext as _ +from gettext import ngettext + +from ._compat import _get_argv_encoding +from ._compat import open_stream +from .exceptions import BadParameter +from .utils import format_filename +from .utils import LazyFile +from .utils import safecall + +if t.TYPE_CHECKING: + import typing_extensions as te + + from .core import Context + from .core import Parameter + from .shell_completion import CompletionItem + + +class ParamType: + """Represents the type of a parameter. Validates and converts values + from the command line or Python into the correct type. + + To implement a custom type, subclass and implement at least the + following: + + - The :attr:`name` class attribute must be set. + - Calling an instance of the type with ``None`` must return + ``None``. This is already implemented by default. + - :meth:`convert` must convert string values to the correct type. + - :meth:`convert` must accept values that are already the correct + type. + - It must be able to convert a value if the ``ctx`` and ``param`` + arguments are ``None``. This can occur when converting prompt + input. + """ + + is_composite: t.ClassVar[bool] = False + arity: t.ClassVar[int] = 1 + + #: the descriptive name of this type + name: str + + #: if a list of this type is expected and the value is pulled from a + #: string environment variable, this is what splits it up. `None` + #: means any whitespace. For all parameters the general rule is that + #: whitespace splits them up. The exception are paths and files which + #: are split by ``os.path.pathsep`` by default (":" on Unix and ";" on + #: Windows). + envvar_list_splitter: t.ClassVar[t.Optional[str]] = None + + def to_info_dict(self) -> t.Dict[str, t.Any]: + """Gather information that could be useful for a tool generating + user-facing documentation. + + Use :meth:`click.Context.to_info_dict` to traverse the entire + CLI structure. + + .. versionadded:: 8.0 + """ + # The class name without the "ParamType" suffix. + param_type = type(self).__name__.partition("ParamType")[0] + param_type = param_type.partition("ParameterType")[0] + + # Custom subclasses might not remember to set a name. + if hasattr(self, "name"): + name = self.name + else: + name = param_type + + return {"param_type": param_type, "name": name} + + def __call__( + self, + value: t.Any, + param: t.Optional["Parameter"] = None, + ctx: t.Optional["Context"] = None, + ) -> t.Any: + if value is not None: + return self.convert(value, param, ctx) + + def get_metavar(self, param: "Parameter") -> t.Optional[str]: + """Returns the metavar default for this param if it provides one.""" + + def get_missing_message(self, param: "Parameter") -> t.Optional[str]: + """Optionally might return extra information about a missing + parameter. + + .. versionadded:: 2.0 + """ + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + """Convert the value to the correct type. This is not called if + the value is ``None`` (the missing value). + + This must accept string values from the command line, as well as + values that are already the correct type. It may also convert + other compatible types. + + The ``param`` and ``ctx`` arguments may be ``None`` in certain + situations, such as when converting prompt input. + + If the value cannot be converted, call :meth:`fail` with a + descriptive message. + + :param value: The value to convert. + :param param: The parameter that is using this type to convert + its value. May be ``None``. + :param ctx: The current context that arrived at this value. May + be ``None``. + """ + return value + + def split_envvar_value(self, rv: str) -> t.Sequence[str]: + """Given a value from an environment variable this splits it up + into small chunks depending on the defined envvar list splitter. + + If the splitter is set to `None`, which means that whitespace splits, + then leading and trailing whitespace is ignored. Otherwise, leading + and trailing splitters usually lead to empty items being included. + """ + return (rv or "").split(self.envvar_list_splitter) + + def fail( + self, + message: str, + param: t.Optional["Parameter"] = None, + ctx: t.Optional["Context"] = None, + ) -> "t.NoReturn": + """Helper method to fail with an invalid value message.""" + raise BadParameter(message, ctx=ctx, param=param) + + def shell_complete( + self, ctx: "Context", param: "Parameter", incomplete: str + ) -> t.List["CompletionItem"]: + """Return a list of + :class:`~click.shell_completion.CompletionItem` objects for the + incomplete value. Most types do not provide completions, but + some do, and this allows custom types to provide custom + completions as well. + + :param ctx: Invocation context for this command. + :param param: The parameter that is requesting completion. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + return [] + + +class CompositeParamType(ParamType): + is_composite = True + + @property + def arity(self) -> int: # type: ignore + raise NotImplementedError() + + +class FuncParamType(ParamType): + def __init__(self, func: t.Callable[[t.Any], t.Any]) -> None: + self.name: str = func.__name__ + self.func = func + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict["func"] = self.func + return info_dict + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + try: + return self.func(value) + except ValueError: + try: + value = str(value) + except UnicodeError: + value = value.decode("utf-8", "replace") + + self.fail(value, param, ctx) + + +class UnprocessedParamType(ParamType): + name = "text" + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + return value + + def __repr__(self) -> str: + return "UNPROCESSED" + + +class StringParamType(ParamType): + name = "text" + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + if isinstance(value, bytes): + enc = _get_argv_encoding() + try: + value = value.decode(enc) + except UnicodeError: + fs_enc = sys.getfilesystemencoding() + if fs_enc != enc: + try: + value = value.decode(fs_enc) + except UnicodeError: + value = value.decode("utf-8", "replace") + else: + value = value.decode("utf-8", "replace") + return value + return str(value) + + def __repr__(self) -> str: + return "STRING" + + +class Choice(ParamType): + """The choice type allows a value to be checked against a fixed set + of supported values. All of these values have to be strings. + + You should only pass a list or tuple of choices. Other iterables + (like generators) may lead to surprising results. + + The resulting value will always be one of the originally passed choices + regardless of ``case_sensitive`` or any ``ctx.token_normalize_func`` + being specified. + + See :ref:`choice-opts` for an example. + + :param case_sensitive: Set to false to make choices case + insensitive. Defaults to true. + """ + + name = "choice" + + def __init__(self, choices: t.Sequence[str], case_sensitive: bool = True) -> None: + self.choices = choices + self.case_sensitive = case_sensitive + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict["choices"] = self.choices + info_dict["case_sensitive"] = self.case_sensitive + return info_dict + + def get_metavar(self, param: "Parameter") -> str: + choices_str = "|".join(self.choices) + + # Use curly braces to indicate a required argument. + if param.required and param.param_type_name == "argument": + return f"{{{choices_str}}}" + + # Use square braces to indicate an option or optional argument. + return f"[{choices_str}]" + + def get_missing_message(self, param: "Parameter") -> str: + return _("Choose from:\n\t{choices}").format(choices=",\n\t".join(self.choices)) + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + # Match through normalization and case sensitivity + # first do token_normalize_func, then lowercase + # preserve original `value` to produce an accurate message in + # `self.fail` + normed_value = value + normed_choices = {choice: choice for choice in self.choices} + + if ctx is not None and ctx.token_normalize_func is not None: + normed_value = ctx.token_normalize_func(value) + normed_choices = { + ctx.token_normalize_func(normed_choice): original + for normed_choice, original in normed_choices.items() + } + + if not self.case_sensitive: + normed_value = normed_value.casefold() + normed_choices = { + normed_choice.casefold(): original + for normed_choice, original in normed_choices.items() + } + + if normed_value in normed_choices: + return normed_choices[normed_value] + + choices_str = ", ".join(map(repr, self.choices)) + self.fail( + ngettext( + "{value!r} is not {choice}.", + "{value!r} is not one of {choices}.", + len(self.choices), + ).format(value=value, choice=choices_str, choices=choices_str), + param, + ctx, + ) + + def __repr__(self) -> str: + return f"Choice({list(self.choices)})" + + def shell_complete( + self, ctx: "Context", param: "Parameter", incomplete: str + ) -> t.List["CompletionItem"]: + """Complete choices that start with the incomplete value. + + :param ctx: Invocation context for this command. + :param param: The parameter that is requesting completion. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + from click.shell_completion import CompletionItem + + str_choices = map(str, self.choices) + + if self.case_sensitive: + matched = (c for c in str_choices if c.startswith(incomplete)) + else: + incomplete = incomplete.lower() + matched = (c for c in str_choices if c.lower().startswith(incomplete)) + + return [CompletionItem(c) for c in matched] + + +class DateTime(ParamType): + """The DateTime type converts date strings into `datetime` objects. + + The format strings which are checked are configurable, but default to some + common (non-timezone aware) ISO 8601 formats. + + When specifying *DateTime* formats, you should only pass a list or a tuple. + Other iterables, like generators, may lead to surprising results. + + The format strings are processed using ``datetime.strptime``, and this + consequently defines the format strings which are allowed. + + Parsing is tried using each format, in order, and the first format which + parses successfully is used. + + :param formats: A list or tuple of date format strings, in the order in + which they should be tried. Defaults to + ``'%Y-%m-%d'``, ``'%Y-%m-%dT%H:%M:%S'``, + ``'%Y-%m-%d %H:%M:%S'``. + """ + + name = "datetime" + + def __init__(self, formats: t.Optional[t.Sequence[str]] = None): + self.formats: t.Sequence[str] = formats or [ + "%Y-%m-%d", + "%Y-%m-%dT%H:%M:%S", + "%Y-%m-%d %H:%M:%S", + ] + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict["formats"] = self.formats + return info_dict + + def get_metavar(self, param: "Parameter") -> str: + return f"[{'|'.join(self.formats)}]" + + def _try_to_convert_date(self, value: t.Any, format: str) -> t.Optional[datetime]: + try: + return datetime.strptime(value, format) + except ValueError: + return None + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + if isinstance(value, datetime): + return value + + for format in self.formats: + converted = self._try_to_convert_date(value, format) + + if converted is not None: + return converted + + formats_str = ", ".join(map(repr, self.formats)) + self.fail( + ngettext( + "{value!r} does not match the format {format}.", + "{value!r} does not match the formats {formats}.", + len(self.formats), + ).format(value=value, format=formats_str, formats=formats_str), + param, + ctx, + ) + + def __repr__(self) -> str: + return "DateTime" + + +class _NumberParamTypeBase(ParamType): + _number_class: t.ClassVar[t.Type[t.Any]] + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + try: + return self._number_class(value) + except ValueError: + self.fail( + _("{value!r} is not a valid {number_type}.").format( + value=value, number_type=self.name + ), + param, + ctx, + ) + + +class _NumberRangeBase(_NumberParamTypeBase): + def __init__( + self, + min: t.Optional[float] = None, + max: t.Optional[float] = None, + min_open: bool = False, + max_open: bool = False, + clamp: bool = False, + ) -> None: + self.min = min + self.max = max + self.min_open = min_open + self.max_open = max_open + self.clamp = clamp + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict.update( + min=self.min, + max=self.max, + min_open=self.min_open, + max_open=self.max_open, + clamp=self.clamp, + ) + return info_dict + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + import operator + + rv = super().convert(value, param, ctx) + lt_min: bool = self.min is not None and ( + operator.le if self.min_open else operator.lt + )(rv, self.min) + gt_max: bool = self.max is not None and ( + operator.ge if self.max_open else operator.gt + )(rv, self.max) + + if self.clamp: + if lt_min: + return self._clamp(self.min, 1, self.min_open) # type: ignore + + if gt_max: + return self._clamp(self.max, -1, self.max_open) # type: ignore + + if lt_min or gt_max: + self.fail( + _("{value} is not in the range {range}.").format( + value=rv, range=self._describe_range() + ), + param, + ctx, + ) + + return rv + + def _clamp(self, bound: float, dir: "te.Literal[1, -1]", open: bool) -> float: + """Find the valid value to clamp to bound in the given + direction. + + :param bound: The boundary value. + :param dir: 1 or -1 indicating the direction to move. + :param open: If true, the range does not include the bound. + """ + raise NotImplementedError + + def _describe_range(self) -> str: + """Describe the range for use in help text.""" + if self.min is None: + op = "<" if self.max_open else "<=" + return f"x{op}{self.max}" + + if self.max is None: + op = ">" if self.min_open else ">=" + return f"x{op}{self.min}" + + lop = "<" if self.min_open else "<=" + rop = "<" if self.max_open else "<=" + return f"{self.min}{lop}x{rop}{self.max}" + + def __repr__(self) -> str: + clamp = " clamped" if self.clamp else "" + return f"<{type(self).__name__} {self._describe_range()}{clamp}>" + + +class IntParamType(_NumberParamTypeBase): + name = "integer" + _number_class = int + + def __repr__(self) -> str: + return "INT" + + +class IntRange(_NumberRangeBase, IntParamType): + """Restrict an :data:`click.INT` value to a range of accepted + values. See :ref:`ranges`. + + If ``min`` or ``max`` are not passed, any value is accepted in that + direction. If ``min_open`` or ``max_open`` are enabled, the + corresponding boundary is not included in the range. + + If ``clamp`` is enabled, a value outside the range is clamped to the + boundary instead of failing. + + .. versionchanged:: 8.0 + Added the ``min_open`` and ``max_open`` parameters. + """ + + name = "integer range" + + def _clamp( # type: ignore + self, bound: int, dir: "te.Literal[1, -1]", open: bool + ) -> int: + if not open: + return bound + + return bound + dir + + +class FloatParamType(_NumberParamTypeBase): + name = "float" + _number_class = float + + def __repr__(self) -> str: + return "FLOAT" + + +class FloatRange(_NumberRangeBase, FloatParamType): + """Restrict a :data:`click.FLOAT` value to a range of accepted + values. See :ref:`ranges`. + + If ``min`` or ``max`` are not passed, any value is accepted in that + direction. If ``min_open`` or ``max_open`` are enabled, the + corresponding boundary is not included in the range. + + If ``clamp`` is enabled, a value outside the range is clamped to the + boundary instead of failing. This is not supported if either + boundary is marked ``open``. + + .. versionchanged:: 8.0 + Added the ``min_open`` and ``max_open`` parameters. + """ + + name = "float range" + + def __init__( + self, + min: t.Optional[float] = None, + max: t.Optional[float] = None, + min_open: bool = False, + max_open: bool = False, + clamp: bool = False, + ) -> None: + super().__init__( + min=min, max=max, min_open=min_open, max_open=max_open, clamp=clamp + ) + + if (min_open or max_open) and clamp: + raise TypeError("Clamping is not supported for open bounds.") + + def _clamp(self, bound: float, dir: "te.Literal[1, -1]", open: bool) -> float: + if not open: + return bound + + # Could use Python 3.9's math.nextafter here, but clamping an + # open float range doesn't seem to be particularly useful. It's + # left up to the user to write a callback to do it if needed. + raise RuntimeError("Clamping is not supported for open bounds.") + + +class BoolParamType(ParamType): + name = "boolean" + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + if value in {False, True}: + return bool(value) + + norm = value.strip().lower() + + if norm in {"1", "true", "t", "yes", "y", "on"}: + return True + + if norm in {"0", "false", "f", "no", "n", "off"}: + return False + + self.fail( + _("{value!r} is not a valid boolean.").format(value=value), param, ctx + ) + + def __repr__(self) -> str: + return "BOOL" + + +class UUIDParameterType(ParamType): + name = "uuid" + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + import uuid + + if isinstance(value, uuid.UUID): + return value + + value = value.strip() + + try: + return uuid.UUID(value) + except ValueError: + self.fail( + _("{value!r} is not a valid UUID.").format(value=value), param, ctx + ) + + def __repr__(self) -> str: + return "UUID" + + +class File(ParamType): + """Declares a parameter to be a file for reading or writing. The file + is automatically closed once the context tears down (after the command + finished working). + + Files can be opened for reading or writing. The special value ``-`` + indicates stdin or stdout depending on the mode. + + By default, the file is opened for reading text data, but it can also be + opened in binary mode or for writing. The encoding parameter can be used + to force a specific encoding. + + The `lazy` flag controls if the file should be opened immediately or upon + first IO. The default is to be non-lazy for standard input and output + streams as well as files opened for reading, `lazy` otherwise. When opening a + file lazily for reading, it is still opened temporarily for validation, but + will not be held open until first IO. lazy is mainly useful when opening + for writing to avoid creating the file until it is needed. + + Files can also be opened atomically in which case all writes go into a + separate file in the same folder and upon completion the file will + be moved over to the original location. This is useful if a file + regularly read by other users is modified. + + See :ref:`file-args` for more information. + + .. versionchanged:: 2.0 + Added the ``atomic`` parameter. + """ + + name = "filename" + envvar_list_splitter: t.ClassVar[str] = os.path.pathsep + + def __init__( + self, + mode: str = "r", + encoding: t.Optional[str] = None, + errors: t.Optional[str] = "strict", + lazy: t.Optional[bool] = None, + atomic: bool = False, + ) -> None: + self.mode = mode + self.encoding = encoding + self.errors = errors + self.lazy = lazy + self.atomic = atomic + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict.update(mode=self.mode, encoding=self.encoding) + return info_dict + + def resolve_lazy_flag(self, value: "t.Union[str, os.PathLike[str]]") -> bool: + if self.lazy is not None: + return self.lazy + if os.fspath(value) == "-": + return False + elif "w" in self.mode: + return True + return False + + def convert( + self, + value: t.Union[str, "os.PathLike[str]", t.IO[t.Any]], + param: t.Optional["Parameter"], + ctx: t.Optional["Context"], + ) -> t.IO[t.Any]: + if _is_file_like(value): + return value + + value = t.cast("t.Union[str, os.PathLike[str]]", value) + + try: + lazy = self.resolve_lazy_flag(value) + + if lazy: + lf = LazyFile( + value, self.mode, self.encoding, self.errors, atomic=self.atomic + ) + + if ctx is not None: + ctx.call_on_close(lf.close_intelligently) + + return t.cast(t.IO[t.Any], lf) + + f, should_close = open_stream( + value, self.mode, self.encoding, self.errors, atomic=self.atomic + ) + + # If a context is provided, we automatically close the file + # at the end of the context execution (or flush out). If a + # context does not exist, it's the caller's responsibility to + # properly close the file. This for instance happens when the + # type is used with prompts. + if ctx is not None: + if should_close: + ctx.call_on_close(safecall(f.close)) + else: + ctx.call_on_close(safecall(f.flush)) + + return f + except OSError as e: + self.fail(f"'{format_filename(value)}': {e.strerror}", param, ctx) + + def shell_complete( + self, ctx: "Context", param: "Parameter", incomplete: str + ) -> t.List["CompletionItem"]: + """Return a special completion marker that tells the completion + system to use the shell to provide file path completions. + + :param ctx: Invocation context for this command. + :param param: The parameter that is requesting completion. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + from click.shell_completion import CompletionItem + + return [CompletionItem(incomplete, type="file")] + + +def _is_file_like(value: t.Any) -> "te.TypeGuard[t.IO[t.Any]]": + return hasattr(value, "read") or hasattr(value, "write") + + +class Path(ParamType): + """The ``Path`` type is similar to the :class:`File` type, but + returns the filename instead of an open file. Various checks can be + enabled to validate the type of file and permissions. + + :param exists: The file or directory needs to exist for the value to + be valid. If this is not set to ``True``, and the file does not + exist, then all further checks are silently skipped. + :param file_okay: Allow a file as a value. + :param dir_okay: Allow a directory as a value. + :param readable: if true, a readable check is performed. + :param writable: if true, a writable check is performed. + :param executable: if true, an executable check is performed. + :param resolve_path: Make the value absolute and resolve any + symlinks. A ``~`` is not expanded, as this is supposed to be + done by the shell only. + :param allow_dash: Allow a single dash as a value, which indicates + a standard stream (but does not open it). Use + :func:`~click.open_file` to handle opening this value. + :param path_type: Convert the incoming path value to this type. If + ``None``, keep Python's default, which is ``str``. Useful to + convert to :class:`pathlib.Path`. + + .. versionchanged:: 8.1 + Added the ``executable`` parameter. + + .. versionchanged:: 8.0 + Allow passing ``path_type=pathlib.Path``. + + .. versionchanged:: 6.0 + Added the ``allow_dash`` parameter. + """ + + envvar_list_splitter: t.ClassVar[str] = os.path.pathsep + + def __init__( + self, + exists: bool = False, + file_okay: bool = True, + dir_okay: bool = True, + writable: bool = False, + readable: bool = True, + resolve_path: bool = False, + allow_dash: bool = False, + path_type: t.Optional[t.Type[t.Any]] = None, + executable: bool = False, + ): + self.exists = exists + self.file_okay = file_okay + self.dir_okay = dir_okay + self.readable = readable + self.writable = writable + self.executable = executable + self.resolve_path = resolve_path + self.allow_dash = allow_dash + self.type = path_type + + if self.file_okay and not self.dir_okay: + self.name: str = _("file") + elif self.dir_okay and not self.file_okay: + self.name = _("directory") + else: + self.name = _("path") + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict.update( + exists=self.exists, + file_okay=self.file_okay, + dir_okay=self.dir_okay, + writable=self.writable, + readable=self.readable, + allow_dash=self.allow_dash, + ) + return info_dict + + def coerce_path_result( + self, value: "t.Union[str, os.PathLike[str]]" + ) -> "t.Union[str, bytes, os.PathLike[str]]": + if self.type is not None and not isinstance(value, self.type): + if self.type is str: + return os.fsdecode(value) + elif self.type is bytes: + return os.fsencode(value) + else: + return t.cast("os.PathLike[str]", self.type(value)) + + return value + + def convert( + self, + value: "t.Union[str, os.PathLike[str]]", + param: t.Optional["Parameter"], + ctx: t.Optional["Context"], + ) -> "t.Union[str, bytes, os.PathLike[str]]": + rv = value + + is_dash = self.file_okay and self.allow_dash and rv in (b"-", "-") + + if not is_dash: + if self.resolve_path: + # os.path.realpath doesn't resolve symlinks on Windows + # until Python 3.8. Use pathlib for now. + import pathlib + + rv = os.fsdecode(pathlib.Path(rv).resolve()) + + try: + st = os.stat(rv) + except OSError: + if not self.exists: + return self.coerce_path_result(rv) + self.fail( + _("{name} {filename!r} does not exist.").format( + name=self.name.title(), filename=format_filename(value) + ), + param, + ctx, + ) + + if not self.file_okay and stat.S_ISREG(st.st_mode): + self.fail( + _("{name} {filename!r} is a file.").format( + name=self.name.title(), filename=format_filename(value) + ), + param, + ctx, + ) + if not self.dir_okay and stat.S_ISDIR(st.st_mode): + self.fail( + _("{name} {filename!r} is a directory.").format( + name=self.name.title(), filename=format_filename(value) + ), + param, + ctx, + ) + + if self.readable and not os.access(rv, os.R_OK): + self.fail( + _("{name} {filename!r} is not readable.").format( + name=self.name.title(), filename=format_filename(value) + ), + param, + ctx, + ) + + if self.writable and not os.access(rv, os.W_OK): + self.fail( + _("{name} {filename!r} is not writable.").format( + name=self.name.title(), filename=format_filename(value) + ), + param, + ctx, + ) + + if self.executable and not os.access(value, os.X_OK): + self.fail( + _("{name} {filename!r} is not executable.").format( + name=self.name.title(), filename=format_filename(value) + ), + param, + ctx, + ) + + return self.coerce_path_result(rv) + + def shell_complete( + self, ctx: "Context", param: "Parameter", incomplete: str + ) -> t.List["CompletionItem"]: + """Return a special completion marker that tells the completion + system to use the shell to provide path completions for only + directories or any paths. + + :param ctx: Invocation context for this command. + :param param: The parameter that is requesting completion. + :param incomplete: Value being completed. May be empty. + + .. versionadded:: 8.0 + """ + from click.shell_completion import CompletionItem + + type = "dir" if self.dir_okay and not self.file_okay else "file" + return [CompletionItem(incomplete, type=type)] + + +class Tuple(CompositeParamType): + """The default behavior of Click is to apply a type on a value directly. + This works well in most cases, except for when `nargs` is set to a fixed + count and different types should be used for different items. In this + case the :class:`Tuple` type can be used. This type can only be used + if `nargs` is set to a fixed number. + + For more information see :ref:`tuple-type`. + + This can be selected by using a Python tuple literal as a type. + + :param types: a list of types that should be used for the tuple items. + """ + + def __init__(self, types: t.Sequence[t.Union[t.Type[t.Any], ParamType]]) -> None: + self.types: t.Sequence[ParamType] = [convert_type(ty) for ty in types] + + def to_info_dict(self) -> t.Dict[str, t.Any]: + info_dict = super().to_info_dict() + info_dict["types"] = [t.to_info_dict() for t in self.types] + return info_dict + + @property + def name(self) -> str: # type: ignore + return f"<{' '.join(ty.name for ty in self.types)}>" + + @property + def arity(self) -> int: # type: ignore + return len(self.types) + + def convert( + self, value: t.Any, param: t.Optional["Parameter"], ctx: t.Optional["Context"] + ) -> t.Any: + len_type = len(self.types) + len_value = len(value) + + if len_value != len_type: + self.fail( + ngettext( + "{len_type} values are required, but {len_value} was given.", + "{len_type} values are required, but {len_value} were given.", + len_value, + ).format(len_type=len_type, len_value=len_value), + param=param, + ctx=ctx, + ) + + return tuple(ty(x, param, ctx) for ty, x in zip(self.types, value)) + + +def convert_type(ty: t.Optional[t.Any], default: t.Optional[t.Any] = None) -> ParamType: + """Find the most appropriate :class:`ParamType` for the given Python + type. If the type isn't provided, it can be inferred from a default + value. + """ + guessed_type = False + + if ty is None and default is not None: + if isinstance(default, (tuple, list)): + # If the default is empty, ty will remain None and will + # return STRING. + if default: + item = default[0] + + # A tuple of tuples needs to detect the inner types. + # Can't call convert recursively because that would + # incorrectly unwind the tuple to a single type. + if isinstance(item, (tuple, list)): + ty = tuple(map(type, item)) + else: + ty = type(item) + else: + ty = type(default) + + guessed_type = True + + if isinstance(ty, tuple): + return Tuple(ty) + + if isinstance(ty, ParamType): + return ty + + if ty is str or ty is None: + return STRING + + if ty is int: + return INT + + if ty is float: + return FLOAT + + if ty is bool: + return BOOL + + if guessed_type: + return STRING + + if __debug__: + try: + if issubclass(ty, ParamType): + raise AssertionError( + f"Attempted to use an uninstantiated parameter type ({ty})." + ) + except TypeError: + # ty is an instance (correct), so issubclass fails. + pass + + return FuncParamType(ty) + + +#: A dummy parameter type that just does nothing. From a user's +#: perspective this appears to just be the same as `STRING` but +#: internally no string conversion takes place if the input was bytes. +#: This is usually useful when working with file paths as they can +#: appear in bytes and unicode. +#: +#: For path related uses the :class:`Path` type is a better choice but +#: there are situations where an unprocessed type is useful which is why +#: it is is provided. +#: +#: .. versionadded:: 4.0 +UNPROCESSED = UnprocessedParamType() + +#: A unicode string parameter type which is the implicit default. This +#: can also be selected by using ``str`` as type. +STRING = StringParamType() + +#: An integer parameter. This can also be selected by using ``int`` as +#: type. +INT = IntParamType() + +#: A floating point value parameter. This can also be selected by using +#: ``float`` as type. +FLOAT = FloatParamType() + +#: A boolean parameter. This is the default for boolean flags. This can +#: also be selected by using ``bool`` as a type. +BOOL = BoolParamType() + +#: A UUID parameter. +UUID = UUIDParameterType() diff --git a/.venv/Lib/site-packages/click/utils.py b/.venv/Lib/site-packages/click/utils.py new file mode 100644 index 0000000..836c6f2 --- /dev/null +++ b/.venv/Lib/site-packages/click/utils.py @@ -0,0 +1,624 @@ +import os +import re +import sys +import typing as t +from functools import update_wrapper +from types import ModuleType +from types import TracebackType + +from ._compat import _default_text_stderr +from ._compat import _default_text_stdout +from ._compat import _find_binary_writer +from ._compat import auto_wrap_for_ansi +from ._compat import binary_streams +from ._compat import open_stream +from ._compat import should_strip_ansi +from ._compat import strip_ansi +from ._compat import text_streams +from ._compat import WIN +from .globals import resolve_color_default + +if t.TYPE_CHECKING: + import typing_extensions as te + + P = te.ParamSpec("P") + +R = t.TypeVar("R") + + +def _posixify(name: str) -> str: + return "-".join(name.split()).lower() + + +def safecall(func: "t.Callable[P, R]") -> "t.Callable[P, t.Optional[R]]": + """Wraps a function so that it swallows exceptions.""" + + def wrapper(*args: "P.args", **kwargs: "P.kwargs") -> t.Optional[R]: + try: + return func(*args, **kwargs) + except Exception: + pass + return None + + return update_wrapper(wrapper, func) + + +def make_str(value: t.Any) -> str: + """Converts a value into a valid string.""" + if isinstance(value, bytes): + try: + return value.decode(sys.getfilesystemencoding()) + except UnicodeError: + return value.decode("utf-8", "replace") + return str(value) + + +def make_default_short_help(help: str, max_length: int = 45) -> str: + """Returns a condensed version of help string.""" + # Consider only the first paragraph. + paragraph_end = help.find("\n\n") + + if paragraph_end != -1: + help = help[:paragraph_end] + + # Collapse newlines, tabs, and spaces. + words = help.split() + + if not words: + return "" + + # The first paragraph started with a "no rewrap" marker, ignore it. + if words[0] == "\b": + words = words[1:] + + total_length = 0 + last_index = len(words) - 1 + + for i, word in enumerate(words): + total_length += len(word) + (i > 0) + + if total_length > max_length: # too long, truncate + break + + if word[-1] == ".": # sentence end, truncate without "..." + return " ".join(words[: i + 1]) + + if total_length == max_length and i != last_index: + break # not at sentence end, truncate with "..." + else: + return " ".join(words) # no truncation needed + + # Account for the length of the suffix. + total_length += len("...") + + # remove words until the length is short enough + while i > 0: + total_length -= len(words[i]) + (i > 0) + + if total_length <= max_length: + break + + i -= 1 + + return " ".join(words[:i]) + "..." + + +class LazyFile: + """A lazy file works like a regular file but it does not fully open + the file but it does perform some basic checks early to see if the + filename parameter does make sense. This is useful for safely opening + files for writing. + """ + + def __init__( + self, + filename: t.Union[str, "os.PathLike[str]"], + mode: str = "r", + encoding: t.Optional[str] = None, + errors: t.Optional[str] = "strict", + atomic: bool = False, + ): + self.name: str = os.fspath(filename) + self.mode = mode + self.encoding = encoding + self.errors = errors + self.atomic = atomic + self._f: t.Optional[t.IO[t.Any]] + self.should_close: bool + + if self.name == "-": + self._f, self.should_close = open_stream(filename, mode, encoding, errors) + else: + if "r" in mode: + # Open and close the file in case we're opening it for + # reading so that we can catch at least some errors in + # some cases early. + open(filename, mode).close() + self._f = None + self.should_close = True + + def __getattr__(self, name: str) -> t.Any: + return getattr(self.open(), name) + + def __repr__(self) -> str: + if self._f is not None: + return repr(self._f) + return f"" + + def open(self) -> t.IO[t.Any]: + """Opens the file if it's not yet open. This call might fail with + a :exc:`FileError`. Not handling this error will produce an error + that Click shows. + """ + if self._f is not None: + return self._f + try: + rv, self.should_close = open_stream( + self.name, self.mode, self.encoding, self.errors, atomic=self.atomic + ) + except OSError as e: + from .exceptions import FileError + + raise FileError(self.name, hint=e.strerror) from e + self._f = rv + return rv + + def close(self) -> None: + """Closes the underlying file, no matter what.""" + if self._f is not None: + self._f.close() + + def close_intelligently(self) -> None: + """This function only closes the file if it was opened by the lazy + file wrapper. For instance this will never close stdin. + """ + if self.should_close: + self.close() + + def __enter__(self) -> "LazyFile": + return self + + def __exit__( + self, + exc_type: t.Optional[t.Type[BaseException]], + exc_value: t.Optional[BaseException], + tb: t.Optional[TracebackType], + ) -> None: + self.close_intelligently() + + def __iter__(self) -> t.Iterator[t.AnyStr]: + self.open() + return iter(self._f) # type: ignore + + +class KeepOpenFile: + def __init__(self, file: t.IO[t.Any]) -> None: + self._file: t.IO[t.Any] = file + + def __getattr__(self, name: str) -> t.Any: + return getattr(self._file, name) + + def __enter__(self) -> "KeepOpenFile": + return self + + def __exit__( + self, + exc_type: t.Optional[t.Type[BaseException]], + exc_value: t.Optional[BaseException], + tb: t.Optional[TracebackType], + ) -> None: + pass + + def __repr__(self) -> str: + return repr(self._file) + + def __iter__(self) -> t.Iterator[t.AnyStr]: + return iter(self._file) + + +def echo( + message: t.Optional[t.Any] = None, + file: t.Optional[t.IO[t.Any]] = None, + nl: bool = True, + err: bool = False, + color: t.Optional[bool] = None, +) -> None: + """Print a message and newline to stdout or a file. This should be + used instead of :func:`print` because it provides better support + for different data, files, and environments. + + Compared to :func:`print`, this does the following: + + - Ensures that the output encoding is not misconfigured on Linux. + - Supports Unicode in the Windows console. + - Supports writing to binary outputs, and supports writing bytes + to text outputs. + - Supports colors and styles on Windows. + - Removes ANSI color and style codes if the output does not look + like an interactive terminal. + - Always flushes the output. + + :param message: The string or bytes to output. Other objects are + converted to strings. + :param file: The file to write to. Defaults to ``stdout``. + :param err: Write to ``stderr`` instead of ``stdout``. + :param nl: Print a newline after the message. Enabled by default. + :param color: Force showing or hiding colors and other styles. By + default Click will remove color if the output does not look like + an interactive terminal. + + .. versionchanged:: 6.0 + Support Unicode output on the Windows console. Click does not + modify ``sys.stdout``, so ``sys.stdout.write()`` and ``print()`` + will still not support Unicode. + + .. versionchanged:: 4.0 + Added the ``color`` parameter. + + .. versionadded:: 3.0 + Added the ``err`` parameter. + + .. versionchanged:: 2.0 + Support colors on Windows if colorama is installed. + """ + if file is None: + if err: + file = _default_text_stderr() + else: + file = _default_text_stdout() + + # There are no standard streams attached to write to. For example, + # pythonw on Windows. + if file is None: + return + + # Convert non bytes/text into the native string type. + if message is not None and not isinstance(message, (str, bytes, bytearray)): + out: t.Optional[t.Union[str, bytes]] = str(message) + else: + out = message + + if nl: + out = out or "" + if isinstance(out, str): + out += "\n" + else: + out += b"\n" + + if not out: + file.flush() + return + + # If there is a message and the value looks like bytes, we manually + # need to find the binary stream and write the message in there. + # This is done separately so that most stream types will work as you + # would expect. Eg: you can write to StringIO for other cases. + if isinstance(out, (bytes, bytearray)): + binary_file = _find_binary_writer(file) + + if binary_file is not None: + file.flush() + binary_file.write(out) + binary_file.flush() + return + + # ANSI style code support. For no message or bytes, nothing happens. + # When outputting to a file instead of a terminal, strip codes. + else: + color = resolve_color_default(color) + + if should_strip_ansi(file, color): + out = strip_ansi(out) + elif WIN: + if auto_wrap_for_ansi is not None: + file = auto_wrap_for_ansi(file, color) # type: ignore + elif not color: + out = strip_ansi(out) + + file.write(out) # type: ignore + file.flush() + + +def get_binary_stream(name: "te.Literal['stdin', 'stdout', 'stderr']") -> t.BinaryIO: + """Returns a system stream for byte processing. + + :param name: the name of the stream to open. Valid names are ``'stdin'``, + ``'stdout'`` and ``'stderr'`` + """ + opener = binary_streams.get(name) + if opener is None: + raise TypeError(f"Unknown standard stream '{name}'") + return opener() + + +def get_text_stream( + name: "te.Literal['stdin', 'stdout', 'stderr']", + encoding: t.Optional[str] = None, + errors: t.Optional[str] = "strict", +) -> t.TextIO: + """Returns a system stream for text processing. This usually returns + a wrapped stream around a binary stream returned from + :func:`get_binary_stream` but it also can take shortcuts for already + correctly configured streams. + + :param name: the name of the stream to open. Valid names are ``'stdin'``, + ``'stdout'`` and ``'stderr'`` + :param encoding: overrides the detected default encoding. + :param errors: overrides the default error mode. + """ + opener = text_streams.get(name) + if opener is None: + raise TypeError(f"Unknown standard stream '{name}'") + return opener(encoding, errors) + + +def open_file( + filename: t.Union[str, "os.PathLike[str]"], + mode: str = "r", + encoding: t.Optional[str] = None, + errors: t.Optional[str] = "strict", + lazy: bool = False, + atomic: bool = False, +) -> t.IO[t.Any]: + """Open a file, with extra behavior to handle ``'-'`` to indicate + a standard stream, lazy open on write, and atomic write. Similar to + the behavior of the :class:`~click.File` param type. + + If ``'-'`` is given to open ``stdout`` or ``stdin``, the stream is + wrapped so that using it in a context manager will not close it. + This makes it possible to use the function without accidentally + closing a standard stream: + + .. code-block:: python + + with open_file(filename) as f: + ... + + :param filename: The name or Path of the file to open, or ``'-'`` for + ``stdin``/``stdout``. + :param mode: The mode in which to open the file. + :param encoding: The encoding to decode or encode a file opened in + text mode. + :param errors: The error handling mode. + :param lazy: Wait to open the file until it is accessed. For read + mode, the file is temporarily opened to raise access errors + early, then closed until it is read again. + :param atomic: Write to a temporary file and replace the given file + on close. + + .. versionadded:: 3.0 + """ + if lazy: + return t.cast( + t.IO[t.Any], LazyFile(filename, mode, encoding, errors, atomic=atomic) + ) + + f, should_close = open_stream(filename, mode, encoding, errors, atomic=atomic) + + if not should_close: + f = t.cast(t.IO[t.Any], KeepOpenFile(f)) + + return f + + +def format_filename( + filename: "t.Union[str, bytes, os.PathLike[str], os.PathLike[bytes]]", + shorten: bool = False, +) -> str: + """Format a filename as a string for display. Ensures the filename can be + displayed by replacing any invalid bytes or surrogate escapes in the name + with the replacement character ``�``. + + Invalid bytes or surrogate escapes will raise an error when written to a + stream with ``errors="strict"``. This will typically happen with ``stdout`` + when the locale is something like ``en_GB.UTF-8``. + + Many scenarios *are* safe to write surrogates though, due to PEP 538 and + PEP 540, including: + + - Writing to ``stderr``, which uses ``errors="backslashreplace"``. + - The system has ``LANG=C.UTF-8``, ``C``, or ``POSIX``. Python opens + stdout and stderr with ``errors="surrogateescape"``. + - None of ``LANG/LC_*`` are set. Python assumes ``LANG=C.UTF-8``. + - Python is started in UTF-8 mode with ``PYTHONUTF8=1`` or ``-X utf8``. + Python opens stdout and stderr with ``errors="surrogateescape"``. + + :param filename: formats a filename for UI display. This will also convert + the filename into unicode without failing. + :param shorten: this optionally shortens the filename to strip of the + path that leads up to it. + """ + if shorten: + filename = os.path.basename(filename) + else: + filename = os.fspath(filename) + + if isinstance(filename, bytes): + filename = filename.decode(sys.getfilesystemencoding(), "replace") + else: + filename = filename.encode("utf-8", "surrogateescape").decode( + "utf-8", "replace" + ) + + return filename + + +def get_app_dir(app_name: str, roaming: bool = True, force_posix: bool = False) -> str: + r"""Returns the config folder for the application. The default behavior + is to return whatever is most appropriate for the operating system. + + To give you an idea, for an app called ``"Foo Bar"``, something like + the following folders could be returned: + + Mac OS X: + ``~/Library/Application Support/Foo Bar`` + Mac OS X (POSIX): + ``~/.foo-bar`` + Unix: + ``~/.config/foo-bar`` + Unix (POSIX): + ``~/.foo-bar`` + Windows (roaming): + ``C:\Users\\AppData\Roaming\Foo Bar`` + Windows (not roaming): + ``C:\Users\\AppData\Local\Foo Bar`` + + .. versionadded:: 2.0 + + :param app_name: the application name. This should be properly capitalized + and can contain whitespace. + :param roaming: controls if the folder should be roaming or not on Windows. + Has no effect otherwise. + :param force_posix: if this is set to `True` then on any POSIX system the + folder will be stored in the home folder with a leading + dot instead of the XDG config home or darwin's + application support folder. + """ + if WIN: + key = "APPDATA" if roaming else "LOCALAPPDATA" + folder = os.environ.get(key) + if folder is None: + folder = os.path.expanduser("~") + return os.path.join(folder, app_name) + if force_posix: + return os.path.join(os.path.expanduser(f"~/.{_posixify(app_name)}")) + if sys.platform == "darwin": + return os.path.join( + os.path.expanduser("~/Library/Application Support"), app_name + ) + return os.path.join( + os.environ.get("XDG_CONFIG_HOME", os.path.expanduser("~/.config")), + _posixify(app_name), + ) + + +class PacifyFlushWrapper: + """This wrapper is used to catch and suppress BrokenPipeErrors resulting + from ``.flush()`` being called on broken pipe during the shutdown/final-GC + of the Python interpreter. Notably ``.flush()`` is always called on + ``sys.stdout`` and ``sys.stderr``. So as to have minimal impact on any + other cleanup code, and the case where the underlying file is not a broken + pipe, all calls and attributes are proxied. + """ + + def __init__(self, wrapped: t.IO[t.Any]) -> None: + self.wrapped = wrapped + + def flush(self) -> None: + try: + self.wrapped.flush() + except OSError as e: + import errno + + if e.errno != errno.EPIPE: + raise + + def __getattr__(self, attr: str) -> t.Any: + return getattr(self.wrapped, attr) + + +def _detect_program_name( + path: t.Optional[str] = None, _main: t.Optional[ModuleType] = None +) -> str: + """Determine the command used to run the program, for use in help + text. If a file or entry point was executed, the file name is + returned. If ``python -m`` was used to execute a module or package, + ``python -m name`` is returned. + + This doesn't try to be too precise, the goal is to give a concise + name for help text. Files are only shown as their name without the + path. ``python`` is only shown for modules, and the full path to + ``sys.executable`` is not shown. + + :param path: The Python file being executed. Python puts this in + ``sys.argv[0]``, which is used by default. + :param _main: The ``__main__`` module. This should only be passed + during internal testing. + + .. versionadded:: 8.0 + Based on command args detection in the Werkzeug reloader. + + :meta private: + """ + if _main is None: + _main = sys.modules["__main__"] + + if not path: + path = sys.argv[0] + + # The value of __package__ indicates how Python was called. It may + # not exist if a setuptools script is installed as an egg. It may be + # set incorrectly for entry points created with pip on Windows. + # It is set to "" inside a Shiv or PEX zipapp. + if getattr(_main, "__package__", None) in {None, ""} or ( + os.name == "nt" + and _main.__package__ == "" + and not os.path.exists(path) + and os.path.exists(f"{path}.exe") + ): + # Executed a file, like "python app.py". + return os.path.basename(path) + + # Executed a module, like "python -m example". + # Rewritten by Python from "-m script" to "/path/to/script.py". + # Need to look at main module to determine how it was executed. + py_module = t.cast(str, _main.__package__) + name = os.path.splitext(os.path.basename(path))[0] + + # A submodule like "example.cli". + if name != "__main__": + py_module = f"{py_module}.{name}" + + return f"python -m {py_module.lstrip('.')}" + + +def _expand_args( + args: t.Iterable[str], + *, + user: bool = True, + env: bool = True, + glob_recursive: bool = True, +) -> t.List[str]: + """Simulate Unix shell expansion with Python functions. + + See :func:`glob.glob`, :func:`os.path.expanduser`, and + :func:`os.path.expandvars`. + + This is intended for use on Windows, where the shell does not do any + expansion. It may not exactly match what a Unix shell would do. + + :param args: List of command line arguments to expand. + :param user: Expand user home directory. + :param env: Expand environment variables. + :param glob_recursive: ``**`` matches directories recursively. + + .. versionchanged:: 8.1 + Invalid glob patterns are treated as empty expansions rather + than raising an error. + + .. versionadded:: 8.0 + + :meta private: + """ + from glob import glob + + out = [] + + for arg in args: + if user: + arg = os.path.expanduser(arg) + + if env: + arg = os.path.expandvars(arg) + + try: + matches = glob(arg, recursive=glob_recursive) + except re.error: + matches = [] + + if not matches: + out.append(arg) + else: + out.extend(matches) + + return out diff --git a/.venv/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/colorama-0.4.6.dist-info/METADATA b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/METADATA new file mode 100644 index 0000000..a1b5c57 --- /dev/null +++ b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/METADATA @@ -0,0 +1,441 @@ +Metadata-Version: 2.1 +Name: colorama +Version: 0.4.6 +Summary: Cross-platform colored terminal text. +Project-URL: Homepage, https://github.com/tartley/colorama +Author-email: Jonathan Hartley +License-File: LICENSE.txt +Keywords: ansi,color,colour,crossplatform,terminal,text,windows,xplatform +Classifier: Development Status :: 5 - Production/Stable +Classifier: Environment :: Console +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: BSD License +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +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 :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Terminals +Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7 +Description-Content-Type: text/x-rst + +.. image:: https://img.shields.io/pypi/v/colorama.svg + :target: https://pypi.org/project/colorama/ + :alt: Latest Version + +.. image:: https://img.shields.io/pypi/pyversions/colorama.svg + :target: https://pypi.org/project/colorama/ + :alt: Supported Python versions + +.. image:: https://github.com/tartley/colorama/actions/workflows/test.yml/badge.svg + :target: https://github.com/tartley/colorama/actions/workflows/test.yml + :alt: Build Status + +Colorama +======== + +Makes ANSI escape character sequences (for producing colored terminal text and +cursor positioning) work under MS Windows. + +.. |donate| image:: https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif + :target: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=2MZ9D2GMLYCUJ&item_name=Colorama¤cy_code=USD + :alt: Donate with Paypal + +`PyPI for releases `_ | +`Github for source `_ | +`Colorama for enterprise on Tidelift `_ + +If you find Colorama useful, please |donate| to the authors. Thank you! + +Installation +------------ + +Tested on CPython 2.7, 3.7, 3.8, 3.9 and 3.10 and Pypy 2.7 and 3.8. + +No requirements other than the standard library. + +.. code-block:: bash + + pip install colorama + # or + conda install -c anaconda colorama + +Description +----------- + +ANSI escape character sequences have long been used to produce colored terminal +text and cursor positioning on Unix and Macs. Colorama makes this work on +Windows, too, by wrapping ``stdout``, stripping ANSI sequences it finds (which +would appear as gobbledygook in the output), and converting them into the +appropriate win32 calls to modify the state of the terminal. On other platforms, +Colorama does nothing. + +This has the upshot of providing a simple cross-platform API for printing +colored terminal text from Python, and has the happy side-effect that existing +applications or libraries which use ANSI sequences to produce colored output on +Linux or Macs can now also work on Windows, simply by calling +``colorama.just_fix_windows_console()`` (since v0.4.6) or ``colorama.init()`` +(all versions, but may have other side-effects – see below). + +An alternative approach is to install ``ansi.sys`` on Windows machines, which +provides the same behaviour for all applications running in terminals. Colorama +is intended for situations where that isn't easy (e.g., maybe your app doesn't +have an installer.) + +Demo scripts in the source code repository print some colored text using +ANSI sequences. Compare their output under Gnome-terminal's built in ANSI +handling, versus on Windows Command-Prompt using Colorama: + +.. image:: https://github.com/tartley/colorama/raw/master/screenshots/ubuntu-demo.png + :width: 661 + :height: 357 + :alt: ANSI sequences on Ubuntu under gnome-terminal. + +.. image:: https://github.com/tartley/colorama/raw/master/screenshots/windows-demo.png + :width: 668 + :height: 325 + :alt: Same ANSI sequences on Windows, using Colorama. + +These screenshots show that, on Windows, Colorama does not support ANSI 'dim +text'; it looks the same as 'normal text'. + +Usage +----- + +Initialisation +.............. + +If the only thing you want from Colorama is to get ANSI escapes to work on +Windows, then run: + +.. code-block:: python + + from colorama import just_fix_windows_console + just_fix_windows_console() + +If you're on a recent version of Windows 10 or better, and your stdout/stderr +are pointing to a Windows console, then this will flip the magic configuration +switch to enable Windows' built-in ANSI support. + +If you're on an older version of Windows, and your stdout/stderr are pointing to +a Windows console, then this will wrap ``sys.stdout`` and/or ``sys.stderr`` in a +magic file object that intercepts ANSI escape sequences and issues the +appropriate Win32 calls to emulate them. + +In all other circumstances, it does nothing whatsoever. Basically the idea is +that this makes Windows act like Unix with respect to ANSI escape handling. + +It's safe to call this function multiple times. It's safe to call this function +on non-Windows platforms, but it won't do anything. It's safe to call this +function when one or both of your stdout/stderr are redirected to a file – it +won't do anything to those streams. + +Alternatively, you can use the older interface with more features (but also more +potential footguns): + +.. code-block:: python + + from colorama import init + init() + +This does the same thing as ``just_fix_windows_console``, except for the +following differences: + +- It's not safe to call ``init`` multiple times; you can end up with multiple + layers of wrapping and broken ANSI support. + +- Colorama will apply a heuristic to guess whether stdout/stderr support ANSI, + and if it thinks they don't, then it will wrap ``sys.stdout`` and + ``sys.stderr`` in a magic file object that strips out ANSI escape sequences + before printing them. This happens on all platforms, and can be convenient if + you want to write your code to emit ANSI escape sequences unconditionally, and + let Colorama decide whether they should actually be output. But note that + Colorama's heuristic is not particularly clever. + +- ``init`` also accepts explicit keyword args to enable/disable various + functionality – see below. + +To stop using Colorama before your program exits, simply call ``deinit()``. +This will restore ``stdout`` and ``stderr`` to their original values, so that +Colorama is disabled. To resume using Colorama again, call ``reinit()``; it is +cheaper than calling ``init()`` again (but does the same thing). + +Most users should depend on ``colorama >= 0.4.6``, and use +``just_fix_windows_console``. The old ``init`` interface will be supported +indefinitely for backwards compatibility, but we don't plan to fix any issues +with it, also for backwards compatibility. + +Colored Output +.............. + +Cross-platform printing of colored text can then be done using Colorama's +constant shorthand for ANSI escape sequences. These are deliberately +rudimentary, see below. + +.. code-block:: python + + from colorama import Fore, Back, Style + print(Fore.RED + 'some red text') + print(Back.GREEN + 'and with a green background') + print(Style.DIM + 'and in dim text') + print(Style.RESET_ALL) + print('back to normal now') + +...or simply by manually printing ANSI sequences from your own code: + +.. code-block:: python + + print('\033[31m' + 'some red text') + print('\033[39m') # and reset to default color + +...or, Colorama can be used in conjunction with existing ANSI libraries +such as the venerable `Termcolor `_ +the fabulous `Blessings `_, +or the incredible `_Rich `_. + +If you wish Colorama's Fore, Back and Style constants were more capable, +then consider using one of the above highly capable libraries to generate +colors, etc, and use Colorama just for its primary purpose: to convert +those ANSI sequences to also work on Windows: + +SIMILARLY, do not send PRs adding the generation of new ANSI types to Colorama. +We are only interested in converting ANSI codes to win32 API calls, not +shortcuts like the above to generate ANSI characters. + +.. code-block:: python + + from colorama import just_fix_windows_console + from termcolor import colored + + # use Colorama to make Termcolor work on Windows too + just_fix_windows_console() + + # then use Termcolor for all colored text output + print(colored('Hello, World!', 'green', 'on_red')) + +Available formatting constants are:: + + Fore: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, RESET. + Back: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, RESET. + Style: DIM, NORMAL, BRIGHT, RESET_ALL + +``Style.RESET_ALL`` resets foreground, background, and brightness. Colorama will +perform this reset automatically on program exit. + +These are fairly well supported, but not part of the standard:: + + Fore: LIGHTBLACK_EX, LIGHTRED_EX, LIGHTGREEN_EX, LIGHTYELLOW_EX, LIGHTBLUE_EX, LIGHTMAGENTA_EX, LIGHTCYAN_EX, LIGHTWHITE_EX + Back: LIGHTBLACK_EX, LIGHTRED_EX, LIGHTGREEN_EX, LIGHTYELLOW_EX, LIGHTBLUE_EX, LIGHTMAGENTA_EX, LIGHTCYAN_EX, LIGHTWHITE_EX + +Cursor Positioning +.................. + +ANSI codes to reposition the cursor are supported. See ``demos/demo06.py`` for +an example of how to generate them. + +Init Keyword Args +................. + +``init()`` accepts some ``**kwargs`` to override default behaviour. + +init(autoreset=False): + If you find yourself repeatedly sending reset sequences to turn off color + changes at the end of every print, then ``init(autoreset=True)`` will + automate that: + + .. code-block:: python + + from colorama import init + init(autoreset=True) + print(Fore.RED + 'some red text') + print('automatically back to default color again') + +init(strip=None): + Pass ``True`` or ``False`` to override whether ANSI codes should be + stripped from the output. The default behaviour is to strip if on Windows + or if output is redirected (not a tty). + +init(convert=None): + Pass ``True`` or ``False`` to override whether to convert ANSI codes in the + output into win32 calls. The default behaviour is to convert if on Windows + and output is to a tty (terminal). + +init(wrap=True): + On Windows, Colorama works by replacing ``sys.stdout`` and ``sys.stderr`` + with proxy objects, which override the ``.write()`` method to do their work. + If this wrapping causes you problems, then this can be disabled by passing + ``init(wrap=False)``. The default behaviour is to wrap if ``autoreset`` or + ``strip`` or ``convert`` are True. + + When wrapping is disabled, colored printing on non-Windows platforms will + continue to work as normal. To do cross-platform colored output, you can + use Colorama's ``AnsiToWin32`` proxy directly: + + .. code-block:: python + + import sys + from colorama import init, AnsiToWin32 + init(wrap=False) + stream = AnsiToWin32(sys.stderr).stream + + # Python 2 + print >>stream, Fore.BLUE + 'blue text on stderr' + + # Python 3 + print(Fore.BLUE + 'blue text on stderr', file=stream) + +Recognised ANSI Sequences +......................... + +ANSI sequences generally take the form:: + + ESC [ ; ... + +Where ```` is an integer, and ```` is a single letter. Zero or +more params are passed to a ````. If no params are passed, it is +generally synonymous with passing a single zero. No spaces exist in the +sequence; they have been inserted here simply to read more easily. + +The only ANSI sequences that Colorama converts into win32 calls are:: + + ESC [ 0 m # reset all (colors and brightness) + ESC [ 1 m # bright + ESC [ 2 m # dim (looks same as normal brightness) + ESC [ 22 m # normal brightness + + # FOREGROUND: + ESC [ 30 m # black + ESC [ 31 m # red + ESC [ 32 m # green + ESC [ 33 m # yellow + ESC [ 34 m # blue + ESC [ 35 m # magenta + ESC [ 36 m # cyan + ESC [ 37 m # white + ESC [ 39 m # reset + + # BACKGROUND + ESC [ 40 m # black + ESC [ 41 m # red + ESC [ 42 m # green + ESC [ 43 m # yellow + ESC [ 44 m # blue + ESC [ 45 m # magenta + ESC [ 46 m # cyan + ESC [ 47 m # white + ESC [ 49 m # reset + + # cursor positioning + ESC [ y;x H # position cursor at x across, y down + ESC [ y;x f # position cursor at x across, y down + ESC [ n A # move cursor n lines up + ESC [ n B # move cursor n lines down + ESC [ n C # move cursor n characters forward + ESC [ n D # move cursor n characters backward + + # clear the screen + ESC [ mode J # clear the screen + + # clear the line + ESC [ mode K # clear the line + +Multiple numeric params to the ``'m'`` command can be combined into a single +sequence:: + + ESC [ 36 ; 45 ; 1 m # bright cyan text on magenta background + +All other ANSI sequences of the form ``ESC [ ; ... `` +are silently stripped from the output on Windows. + +Any other form of ANSI sequence, such as single-character codes or alternative +initial characters, are not recognised or stripped. It would be cool to add +them though. Let me know if it would be useful for you, via the Issues on +GitHub. + +Status & Known Problems +----------------------- + +I've personally only tested it on Windows XP (CMD, Console2), Ubuntu +(gnome-terminal, xterm), and OS X. + +Some valid ANSI sequences aren't recognised. + +If you're hacking on the code, see `README-hacking.md`_. ESPECIALLY, see the +explanation there of why we do not want PRs that allow Colorama to generate new +types of ANSI codes. + +See outstanding issues and wish-list: +https://github.com/tartley/colorama/issues + +If anything doesn't work for you, or doesn't do what you expected or hoped for, +I'd love to hear about it on that issues list, would be delighted by patches, +and would be happy to grant commit access to anyone who submits a working patch +or two. + +.. _README-hacking.md: README-hacking.md + +License +------- + +Copyright Jonathan Hartley & Arnon Yaari, 2013-2020. BSD 3-Clause license; see +LICENSE file. + +Professional support +-------------------- + +.. |tideliftlogo| image:: https://cdn2.hubspot.net/hubfs/4008838/website/logos/logos_for_download/Tidelift_primary-shorthand-logo.png + :alt: Tidelift + :target: https://tidelift.com/subscription/pkg/pypi-colorama?utm_source=pypi-colorama&utm_medium=referral&utm_campaign=readme + +.. list-table:: + :widths: 10 100 + + * - |tideliftlogo| + - Professional support for colorama is available as part of the + `Tidelift Subscription`_. + Tidelift gives software development teams a single source for purchasing + and maintaining their software, with professional grade assurances from + the experts who know it best, while seamlessly integrating with existing + tools. + +.. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-colorama?utm_source=pypi-colorama&utm_medium=referral&utm_campaign=readme + +Thanks +------ + +See the CHANGELOG for more thanks! + +* Marc Schlaich (schlamar) for a ``setup.py`` fix for Python2.5. +* Marc Abramowitz, reported & fixed a crash on exit with closed ``stdout``, + providing a solution to issue #7's setuptools/distutils debate, + and other fixes. +* User 'eryksun', for guidance on correctly instantiating ``ctypes.windll``. +* Matthew McCormick for politely pointing out a longstanding crash on non-Win. +* Ben Hoyt, for a magnificent fix under 64-bit Windows. +* Jesse at Empty Square for submitting a fix for examples in the README. +* User 'jamessp', an observant documentation fix for cursor positioning. +* User 'vaal1239', Dave Mckee & Lackner Kristof for a tiny but much-needed Win7 + fix. +* Julien Stuyck, for wisely suggesting Python3 compatible updates to README. +* Daniel Griffith for multiple fabulous patches. +* Oscar Lesta for a valuable fix to stop ANSI chars being sent to non-tty + output. +* Roger Binns, for many suggestions, valuable feedback, & bug reports. +* Tim Golden for thought and much appreciated feedback on the initial idea. +* User 'Zearin' for updates to the README file. +* John Szakmeister for adding support for light colors +* Charles Merriam for adding documentation to demos +* Jurko for a fix on 64-bit Windows CPython2.5 w/o ctypes +* Florian Bruhin for a fix when stdout or stderr are None +* Thomas Weininger for fixing ValueError on Windows +* Remi Rampin for better Github integration and fixes to the README file +* Simeon Visser for closing a file handle using 'with' and updating classifiers + to include Python 3.3 and 3.4 +* Andy Neff for fixing RESET of LIGHT_EX colors. +* Jonathan Hartley for the initial idea and implementation. diff --git a/.venv/Lib/site-packages/colorama-0.4.6.dist-info/RECORD b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/RECORD new file mode 100644 index 0000000..cd6b130 --- /dev/null +++ b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/RECORD @@ -0,0 +1,31 @@ +colorama-0.4.6.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +colorama-0.4.6.dist-info/METADATA,sha256=e67SnrUMOym9sz_4TjF3vxvAV4T3aF7NyqRHHH3YEMw,17158 +colorama-0.4.6.dist-info/RECORD,, +colorama-0.4.6.dist-info/WHEEL,sha256=cdcF4Fbd0FPtw2EMIOwH-3rSOTUdTCeOSXRMD1iLUb8,105 +colorama-0.4.6.dist-info/licenses/LICENSE.txt,sha256=ysNcAmhuXQSlpxQL-zs25zrtSWZW6JEQLkKIhteTAxg,1491 +colorama/__init__.py,sha256=wePQA4U20tKgYARySLEC047ucNX-g8pRLpYBuiHlLb8,266 +colorama/__pycache__/__init__.cpython-312.pyc,, +colorama/__pycache__/ansi.cpython-312.pyc,, +colorama/__pycache__/ansitowin32.cpython-312.pyc,, +colorama/__pycache__/initialise.cpython-312.pyc,, +colorama/__pycache__/win32.cpython-312.pyc,, +colorama/__pycache__/winterm.cpython-312.pyc,, +colorama/ansi.py,sha256=Top4EeEuaQdBWdteKMEcGOTeKeF19Q-Wo_6_Cj5kOzQ,2522 +colorama/ansitowin32.py,sha256=vPNYa3OZbxjbuFyaVo0Tmhmy1FZ1lKMWCnT7odXpItk,11128 +colorama/initialise.py,sha256=-hIny86ClXo39ixh5iSCfUIa2f_h_bgKRDW7gqs-KLU,3325 +colorama/tests/__init__.py,sha256=MkgPAEzGQd-Rq0w0PZXSX2LadRWhUECcisJY8lSrm4Q,75 +colorama/tests/__pycache__/__init__.cpython-312.pyc,, +colorama/tests/__pycache__/ansi_test.cpython-312.pyc,, +colorama/tests/__pycache__/ansitowin32_test.cpython-312.pyc,, +colorama/tests/__pycache__/initialise_test.cpython-312.pyc,, +colorama/tests/__pycache__/isatty_test.cpython-312.pyc,, +colorama/tests/__pycache__/utils.cpython-312.pyc,, +colorama/tests/__pycache__/winterm_test.cpython-312.pyc,, +colorama/tests/ansi_test.py,sha256=FeViDrUINIZcr505PAxvU4AjXz1asEiALs9GXMhwRaE,2839 +colorama/tests/ansitowin32_test.py,sha256=RN7AIhMJ5EqDsYaCjVo-o4u8JzDD4ukJbmevWKS70rY,10678 +colorama/tests/initialise_test.py,sha256=BbPy-XfyHwJ6zKozuQOvNvQZzsx9vdb_0bYXn7hsBTc,6741 +colorama/tests/isatty_test.py,sha256=Pg26LRpv0yQDB5Ac-sxgVXG7hsA1NYvapFgApZfYzZg,1866 +colorama/tests/utils.py,sha256=1IIRylG39z5-dzq09R_ngufxyPZxgldNbrxKxUGwGKE,1079 +colorama/tests/winterm_test.py,sha256=qoWFPEjym5gm2RuMwpf3pOis3a5r_PJZFCzK254JL8A,3709 +colorama/win32.py,sha256=YQOKwMTwtGBbsY4dL5HYTvwTeP9wIQra5MvPNddpxZs,6181 +colorama/winterm.py,sha256=XCQFDHjPi6AHYNdZwy0tA02H-Jh48Jp-HvCjeLeLp3U,7134 diff --git a/.venv/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL new file mode 100644 index 0000000..d79189f --- /dev/null +++ b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: hatchling 1.11.1 +Root-Is-Purelib: true +Tag: py2-none-any +Tag: py3-none-any diff --git a/.venv/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt new file mode 100644 index 0000000..3105888 --- /dev/null +++ b/.venv/Lib/site-packages/colorama-0.4.6.dist-info/licenses/LICENSE.txt @@ -0,0 +1,27 @@ +Copyright (c) 2010 Jonathan Hartley +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 holders, nor those 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/.venv/Lib/site-packages/colorama/__init__.py b/.venv/Lib/site-packages/colorama/__init__.py new file mode 100644 index 0000000..383101c --- /dev/null +++ b/.venv/Lib/site-packages/colorama/__init__.py @@ -0,0 +1,7 @@ +# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file. +from .initialise import init, deinit, reinit, colorama_text, just_fix_windows_console +from .ansi import Fore, Back, Style, Cursor +from .ansitowin32 import AnsiToWin32 + +__version__ = '0.4.6' + diff --git a/.venv/Lib/site-packages/colorama/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/colorama/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7dd8e072ac7381543845d6070e89f4b3d39e0790 GIT binary patch literal 506 zcmXv~O=}cE5bfFNnf;jE93(=#dl^F3kcbcwAqIj6(SR;O)6jHg+O?DJ>7jadlg%x^ z!r$O;@hDyzf`SL}CImcqvf7wByn0oS?pIZxCX*4t`2Ff?K1vAr9*f)P{U_JYk$fOE zsS`tN!V=qKJ)5%BQbujYvLtFfliNP)+W{NcAsgBe!w<2an!=9R7&&E=RaWLd(T9{- zpt{jr$ZK_z;U-TiXB^@N%DitzL42hviX^8UXlCX*6v;wa0k`D($bTX literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/__pycache__/ansi.cpython-312.pyc b/.venv/Lib/site-packages/colorama/__pycache__/ansi.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..34d2e0ff8aaab12002eccc2fbd950f16df00bc95 GIT binary patch literal 3959 zcmcgv&2JmW6`%d$_lHFKOLCgfvD1`^P1$YHCUQ}iq9|E0MG2x5#~ZraHFqPeO_A*E z$|+R^paC6X*asB}Y8?&4hZw%(|LDa+kir=_r=0d?mqZRZ^}Sh=CWROX61NM?Z{B+| zoO$!+_hyFwibg{OzV8;kS!F>&zD1??DP5ucZxHSfgQ&z1RKXBc(U4Thkhh5{8w#Le zBn{uTp!%TpL+uyIEHMJx#0Z*!2a-3A8sydxSi=L>5VuCa8a0FczF}^Sfi*s0jd1G- zSVsq}QIVM82VG~?7-*5c76&cb*G51K^|jGvB7I=96R~(b3Ds=;lPCeD2R?V?$t6-_tDK|m;x>eJwb|zFZ&B@f7<1{8GCd^vq zL+hH=Fbzx3)amL3Y7;oFX4)0KVQM&NXj44;K9tK$@K=QHDzK8FVCdQ>0qzh7(EFTj zKnd9*54ykDgeF5kERnQWWWxG=kx9AI9FuH^rUfSR1z_*g_f~GQykeWwF6)*-ExWwf z#D%Ue()v}i;@IT|J=G0FotCThRl9rzP}3U?ZGGd~+o#K!>t^kGxnNx>+m>UVYUq_~ z`l@M{c}(Kaa9QzTmiO8X!{i#!g;K27c{e=>IS+-_+voO&py z+R#9T;vj;7$Kh8X493A*?-s#TJJ^eV{TOVDzdoCWAS{$}Oq$9UAP9%2@krI_(*j8y>ca+B? zhj-;&fN>|Ml{%{aY{%?71IyU4YBMZ-`LKP)krNP|HyJ zi~w91a6vSE=^zX7Kx|OEPAk3faDpF`RQ-*|d>=abvR+b&^i^nKLe0jZd%Ga6EN(`h zO`BO+#7Ojxqj=)e((dRd@7~E}2jPi1o#hGK$-H;3IAJQVu8 zc?bFo-V_5jWT*2X>p;n85`I`&`*IY z_Hh8XQTEa6UhZ?@vzfj48=sf<;-?=5PIog{aPb^Wi!=)rhjf7c5@pT@yawrM1WY~p zdxS}ZKOyj4LbiBm&7*~I0*Z}Ej%h6@ueRkO=zx00OLgo$lAnmTxUV3j5RM^W7P}Zg7nk5-y1Ez#S4DUqp^R`D;m-&f!e0<{fa3iF`+~=m zsR9s*NlW=@rpzwo^F`*nlrIz(E;4zlu##u~`Rr`IxSVBj?ozhMl#A!*mh((m%9rxX zELxbGJ-^I{(DLuGFjrwHRJ=AmB&spq<_(Q{r2EsAJZf>Sb*FmPj8mfKjm4)1b^pfZ zU}+Qqj|ck_z&3ew=twJ%kn2k`C`}{G_9fmW|HMZQkG1B}dI5n;MU)B%3q9$^yhjV1 zs{*C}{aq{Tv^9f}do+^Z(v3NfAlR{(7U&k#=>+p@no+N48ufurV+i=V=FcVm*52cC$NDje8tR{JBK<1s?K;)82h-{ yAy9QrCWUcN9`Br#g~U#0 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/__pycache__/ansitowin32.cpython-312.pyc b/.venv/Lib/site-packages/colorama/__pycache__/ansitowin32.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..af9641e4fb7ce4fc64d7c80510834c3a5e3b98d7 GIT binary patch literal 16426 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/__pycache__/initialise.cpython-312.pyc b/.venv/Lib/site-packages/colorama/__pycache__/initialise.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..837b1c86b9c89b6a641d69328ba9105fc0bf4276 GIT binary patch literal 3564 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 W2{o$?*PGE7&9>_o^k1B(p!`2QJR%bS literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/__pycache__/winterm.cpython-312.pyc b/.venv/Lib/site-packages/colorama/__pycache__/winterm.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8318903c77ac90b91024aae4b397cbe436ae3ca2 GIT binary patch literal 9102 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/ansi.py b/.venv/Lib/site-packages/colorama/ansi.py new file mode 100644 index 0000000..11ec695 --- /dev/null +++ b/.venv/Lib/site-packages/colorama/ansi.py @@ -0,0 +1,102 @@ +# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file. +''' +This module generates ANSI character codes to printing colors to terminals. +See: http://en.wikipedia.org/wiki/ANSI_escape_code +''' + +CSI = '\033[' +OSC = '\033]' +BEL = '\a' + + +def code_to_chars(code): + return CSI + str(code) + 'm' + +def set_title(title): + return OSC + '2;' + title + BEL + +def clear_screen(mode=2): + return CSI + str(mode) + 'J' + +def clear_line(mode=2): + return CSI + str(mode) + 'K' + + +class AnsiCodes(object): + def __init__(self): + # the subclasses declare class attributes which are numbers. + # Upon instantiation we define instance attributes, which are the same + # as the class attributes but wrapped with the ANSI escape sequence + for name in dir(self): + if not name.startswith('_'): + value = getattr(self, name) + setattr(self, name, code_to_chars(value)) + + +class AnsiCursor(object): + def UP(self, n=1): + return CSI + str(n) + 'A' + def DOWN(self, n=1): + return CSI + str(n) + 'B' + def FORWARD(self, n=1): + return CSI + str(n) + 'C' + def BACK(self, n=1): + return CSI + str(n) + 'D' + def POS(self, x=1, y=1): + return CSI + str(y) + ';' + str(x) + 'H' + + +class AnsiFore(AnsiCodes): + BLACK = 30 + RED = 31 + GREEN = 32 + YELLOW = 33 + BLUE = 34 + MAGENTA = 35 + CYAN = 36 + WHITE = 37 + RESET = 39 + + # These are fairly well supported, but not part of the standard. + LIGHTBLACK_EX = 90 + LIGHTRED_EX = 91 + LIGHTGREEN_EX = 92 + LIGHTYELLOW_EX = 93 + LIGHTBLUE_EX = 94 + LIGHTMAGENTA_EX = 95 + LIGHTCYAN_EX = 96 + LIGHTWHITE_EX = 97 + + +class AnsiBack(AnsiCodes): + BLACK = 40 + RED = 41 + GREEN = 42 + YELLOW = 43 + BLUE = 44 + MAGENTA = 45 + CYAN = 46 + WHITE = 47 + RESET = 49 + + # These are fairly well supported, but not part of the standard. + LIGHTBLACK_EX = 100 + LIGHTRED_EX = 101 + LIGHTGREEN_EX = 102 + LIGHTYELLOW_EX = 103 + LIGHTBLUE_EX = 104 + LIGHTMAGENTA_EX = 105 + LIGHTCYAN_EX = 106 + LIGHTWHITE_EX = 107 + + +class AnsiStyle(AnsiCodes): + BRIGHT = 1 + DIM = 2 + NORMAL = 22 + RESET_ALL = 0 + +Fore = AnsiFore() +Back = AnsiBack() +Style = AnsiStyle() +Cursor = AnsiCursor() diff --git a/.venv/Lib/site-packages/colorama/ansitowin32.py b/.venv/Lib/site-packages/colorama/ansitowin32.py new file mode 100644 index 0000000..abf209e --- /dev/null +++ b/.venv/Lib/site-packages/colorama/ansitowin32.py @@ -0,0 +1,277 @@ +# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file. +import re +import sys +import os + +from .ansi import AnsiFore, AnsiBack, AnsiStyle, Style, BEL +from .winterm import enable_vt_processing, WinTerm, WinColor, WinStyle +from .win32 import windll, winapi_test + + +winterm = None +if windll is not None: + winterm = WinTerm() + + +class StreamWrapper(object): + ''' + Wraps a stream (such as stdout), acting as a transparent proxy for all + attribute access apart from method 'write()', which is delegated to our + Converter instance. + ''' + def __init__(self, wrapped, converter): + # double-underscore everything to prevent clashes with names of + # attributes on the wrapped stream object. + self.__wrapped = wrapped + self.__convertor = converter + + def __getattr__(self, name): + return getattr(self.__wrapped, name) + + def __enter__(self, *args, **kwargs): + # special method lookup bypasses __getattr__/__getattribute__, see + # https://stackoverflow.com/questions/12632894/why-doesnt-getattr-work-with-exit + # thus, contextlib magic methods are not proxied via __getattr__ + return self.__wrapped.__enter__(*args, **kwargs) + + def __exit__(self, *args, **kwargs): + return self.__wrapped.__exit__(*args, **kwargs) + + def __setstate__(self, state): + self.__dict__ = state + + def __getstate__(self): + return self.__dict__ + + def write(self, text): + self.__convertor.write(text) + + def isatty(self): + stream = self.__wrapped + if 'PYCHARM_HOSTED' in os.environ: + if stream is not None and (stream is sys.__stdout__ or stream is sys.__stderr__): + return True + try: + stream_isatty = stream.isatty + except AttributeError: + return False + else: + return stream_isatty() + + @property + def closed(self): + stream = self.__wrapped + try: + return stream.closed + # AttributeError in the case that the stream doesn't support being closed + # ValueError for the case that the stream has already been detached when atexit runs + except (AttributeError, ValueError): + return True + + +class AnsiToWin32(object): + ''' + Implements a 'write()' method which, on Windows, will strip ANSI character + sequences from the text, and if outputting to a tty, will convert them into + win32 function calls. + ''' + ANSI_CSI_RE = re.compile('\001?\033\\[((?:\\d|;)*)([a-zA-Z])\002?') # Control Sequence Introducer + ANSI_OSC_RE = re.compile('\001?\033\\]([^\a]*)(\a)\002?') # Operating System Command + + def __init__(self, wrapped, convert=None, strip=None, autoreset=False): + # The wrapped stream (normally sys.stdout or sys.stderr) + self.wrapped = wrapped + + # should we reset colors to defaults after every .write() + self.autoreset = autoreset + + # create the proxy wrapping our output stream + self.stream = StreamWrapper(wrapped, self) + + on_windows = os.name == 'nt' + # We test if the WinAPI works, because even if we are on Windows + # we may be using a terminal that doesn't support the WinAPI + # (e.g. Cygwin Terminal). In this case it's up to the terminal + # to support the ANSI codes. + conversion_supported = on_windows and winapi_test() + try: + fd = wrapped.fileno() + except Exception: + fd = -1 + system_has_native_ansi = not on_windows or enable_vt_processing(fd) + have_tty = not self.stream.closed and self.stream.isatty() + need_conversion = conversion_supported and not system_has_native_ansi + + # should we strip ANSI sequences from our output? + if strip is None: + strip = need_conversion or not have_tty + self.strip = strip + + # should we should convert ANSI sequences into win32 calls? + if convert is None: + convert = need_conversion and have_tty + self.convert = convert + + # dict of ansi codes to win32 functions and parameters + self.win32_calls = self.get_win32_calls() + + # are we wrapping stderr? + self.on_stderr = self.wrapped is sys.stderr + + def should_wrap(self): + ''' + True if this class is actually needed. If false, then the output + stream will not be affected, nor will win32 calls be issued, so + wrapping stdout is not actually required. This will generally be + False on non-Windows platforms, unless optional functionality like + autoreset has been requested using kwargs to init() + ''' + return self.convert or self.strip or self.autoreset + + def get_win32_calls(self): + if self.convert and winterm: + return { + AnsiStyle.RESET_ALL: (winterm.reset_all, ), + AnsiStyle.BRIGHT: (winterm.style, WinStyle.BRIGHT), + AnsiStyle.DIM: (winterm.style, WinStyle.NORMAL), + AnsiStyle.NORMAL: (winterm.style, WinStyle.NORMAL), + AnsiFore.BLACK: (winterm.fore, WinColor.BLACK), + AnsiFore.RED: (winterm.fore, WinColor.RED), + AnsiFore.GREEN: (winterm.fore, WinColor.GREEN), + AnsiFore.YELLOW: (winterm.fore, WinColor.YELLOW), + AnsiFore.BLUE: (winterm.fore, WinColor.BLUE), + AnsiFore.MAGENTA: (winterm.fore, WinColor.MAGENTA), + AnsiFore.CYAN: (winterm.fore, WinColor.CYAN), + AnsiFore.WHITE: (winterm.fore, WinColor.GREY), + AnsiFore.RESET: (winterm.fore, ), + AnsiFore.LIGHTBLACK_EX: (winterm.fore, WinColor.BLACK, True), + AnsiFore.LIGHTRED_EX: (winterm.fore, WinColor.RED, True), + AnsiFore.LIGHTGREEN_EX: (winterm.fore, WinColor.GREEN, True), + AnsiFore.LIGHTYELLOW_EX: (winterm.fore, WinColor.YELLOW, True), + AnsiFore.LIGHTBLUE_EX: (winterm.fore, WinColor.BLUE, True), + AnsiFore.LIGHTMAGENTA_EX: (winterm.fore, WinColor.MAGENTA, True), + AnsiFore.LIGHTCYAN_EX: (winterm.fore, WinColor.CYAN, True), + AnsiFore.LIGHTWHITE_EX: (winterm.fore, WinColor.GREY, True), + AnsiBack.BLACK: (winterm.back, WinColor.BLACK), + AnsiBack.RED: (winterm.back, WinColor.RED), + AnsiBack.GREEN: (winterm.back, WinColor.GREEN), + AnsiBack.YELLOW: (winterm.back, WinColor.YELLOW), + AnsiBack.BLUE: (winterm.back, WinColor.BLUE), + AnsiBack.MAGENTA: (winterm.back, WinColor.MAGENTA), + AnsiBack.CYAN: (winterm.back, WinColor.CYAN), + AnsiBack.WHITE: (winterm.back, WinColor.GREY), + AnsiBack.RESET: (winterm.back, ), + AnsiBack.LIGHTBLACK_EX: (winterm.back, WinColor.BLACK, True), + AnsiBack.LIGHTRED_EX: (winterm.back, WinColor.RED, True), + AnsiBack.LIGHTGREEN_EX: (winterm.back, WinColor.GREEN, True), + AnsiBack.LIGHTYELLOW_EX: (winterm.back, WinColor.YELLOW, True), + AnsiBack.LIGHTBLUE_EX: (winterm.back, WinColor.BLUE, True), + AnsiBack.LIGHTMAGENTA_EX: (winterm.back, WinColor.MAGENTA, True), + AnsiBack.LIGHTCYAN_EX: (winterm.back, WinColor.CYAN, True), + AnsiBack.LIGHTWHITE_EX: (winterm.back, WinColor.GREY, True), + } + return dict() + + def write(self, text): + if self.strip or self.convert: + self.write_and_convert(text) + else: + self.wrapped.write(text) + self.wrapped.flush() + if self.autoreset: + self.reset_all() + + + def reset_all(self): + if self.convert: + self.call_win32('m', (0,)) + elif not self.strip and not self.stream.closed: + self.wrapped.write(Style.RESET_ALL) + + + def write_and_convert(self, text): + ''' + Write the given text to our wrapped stream, stripping any ANSI + sequences from the text, and optionally converting them into win32 + calls. + ''' + cursor = 0 + text = self.convert_osc(text) + for match in self.ANSI_CSI_RE.finditer(text): + start, end = match.span() + self.write_plain_text(text, cursor, start) + self.convert_ansi(*match.groups()) + cursor = end + self.write_plain_text(text, cursor, len(text)) + + + def write_plain_text(self, text, start, end): + if start < end: + self.wrapped.write(text[start:end]) + self.wrapped.flush() + + + def convert_ansi(self, paramstring, command): + if self.convert: + params = self.extract_params(command, paramstring) + self.call_win32(command, params) + + + def extract_params(self, command, paramstring): + if command in 'Hf': + params = tuple(int(p) if len(p) != 0 else 1 for p in paramstring.split(';')) + while len(params) < 2: + # defaults: + params = params + (1,) + else: + params = tuple(int(p) for p in paramstring.split(';') if len(p) != 0) + if len(params) == 0: + # defaults: + if command in 'JKm': + params = (0,) + elif command in 'ABCD': + params = (1,) + + return params + + + def call_win32(self, command, params): + if command == 'm': + for param in params: + if param in self.win32_calls: + func_args = self.win32_calls[param] + func = func_args[0] + args = func_args[1:] + kwargs = dict(on_stderr=self.on_stderr) + func(*args, **kwargs) + elif command in 'J': + winterm.erase_screen(params[0], on_stderr=self.on_stderr) + elif command in 'K': + winterm.erase_line(params[0], on_stderr=self.on_stderr) + elif command in 'Hf': # cursor position - absolute + winterm.set_cursor_position(params, on_stderr=self.on_stderr) + elif command in 'ABCD': # cursor position - relative + n = params[0] + # A - up, B - down, C - forward, D - back + x, y = {'A': (0, -n), 'B': (0, n), 'C': (n, 0), 'D': (-n, 0)}[command] + winterm.cursor_adjust(x, y, on_stderr=self.on_stderr) + + + def convert_osc(self, text): + for match in self.ANSI_OSC_RE.finditer(text): + start, end = match.span() + text = text[:start] + text[end:] + paramstring, command = match.groups() + if command == BEL: + if paramstring.count(";") == 1: + params = paramstring.split(";") + # 0 - change title and icon (we will only change title) + # 1 - change icon (we don't support this) + # 2 - change title + if params[0] in '02': + winterm.set_title(params[1]) + return text + + + def flush(self): + self.wrapped.flush() diff --git a/.venv/Lib/site-packages/colorama/initialise.py b/.venv/Lib/site-packages/colorama/initialise.py new file mode 100644 index 0000000..d5fd4b7 --- /dev/null +++ b/.venv/Lib/site-packages/colorama/initialise.py @@ -0,0 +1,121 @@ +# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file. +import atexit +import contextlib +import sys + +from .ansitowin32 import AnsiToWin32 + + +def _wipe_internal_state_for_tests(): + global orig_stdout, orig_stderr + orig_stdout = None + orig_stderr = None + + global wrapped_stdout, wrapped_stderr + wrapped_stdout = None + wrapped_stderr = None + + global atexit_done + atexit_done = False + + global fixed_windows_console + fixed_windows_console = False + + try: + # no-op if it wasn't registered + atexit.unregister(reset_all) + except AttributeError: + # python 2: no atexit.unregister. Oh well, we did our best. + pass + + +def reset_all(): + if AnsiToWin32 is not None: # Issue #74: objects might become None at exit + AnsiToWin32(orig_stdout).reset_all() + + +def init(autoreset=False, convert=None, strip=None, wrap=True): + + if not wrap and any([autoreset, convert, strip]): + raise ValueError('wrap=False conflicts with any other arg=True') + + global wrapped_stdout, wrapped_stderr + global orig_stdout, orig_stderr + + orig_stdout = sys.stdout + orig_stderr = sys.stderr + + if sys.stdout is None: + wrapped_stdout = None + else: + sys.stdout = wrapped_stdout = \ + wrap_stream(orig_stdout, convert, strip, autoreset, wrap) + if sys.stderr is None: + wrapped_stderr = None + else: + sys.stderr = wrapped_stderr = \ + wrap_stream(orig_stderr, convert, strip, autoreset, wrap) + + global atexit_done + if not atexit_done: + atexit.register(reset_all) + atexit_done = True + + +def deinit(): + if orig_stdout is not None: + sys.stdout = orig_stdout + if orig_stderr is not None: + sys.stderr = orig_stderr + + +def just_fix_windows_console(): + global fixed_windows_console + + if sys.platform != "win32": + return + if fixed_windows_console: + return + if wrapped_stdout is not None or wrapped_stderr is not None: + # Someone already ran init() and it did stuff, so we won't second-guess them + return + + # On newer versions of Windows, AnsiToWin32.__init__ will implicitly enable the + # native ANSI support in the console as a side-effect. We only need to actually + # replace sys.stdout/stderr if we're in the old-style conversion mode. + new_stdout = AnsiToWin32(sys.stdout, convert=None, strip=None, autoreset=False) + if new_stdout.convert: + sys.stdout = new_stdout + new_stderr = AnsiToWin32(sys.stderr, convert=None, strip=None, autoreset=False) + if new_stderr.convert: + sys.stderr = new_stderr + + fixed_windows_console = True + +@contextlib.contextmanager +def colorama_text(*args, **kwargs): + init(*args, **kwargs) + try: + yield + finally: + deinit() + + +def reinit(): + if wrapped_stdout is not None: + sys.stdout = wrapped_stdout + if wrapped_stderr is not None: + sys.stderr = wrapped_stderr + + +def wrap_stream(stream, convert, strip, autoreset, wrap): + if wrap: + wrapper = AnsiToWin32(stream, + convert=convert, strip=strip, autoreset=autoreset) + if wrapper.should_wrap(): + stream = wrapper.stream + return stream + + +# Use this for initial setup as well, to reduce code duplication +_wipe_internal_state_for_tests() diff --git a/.venv/Lib/site-packages/colorama/tests/__init__.py b/.venv/Lib/site-packages/colorama/tests/__init__.py new file mode 100644 index 0000000..8c5661e --- /dev/null +++ b/.venv/Lib/site-packages/colorama/tests/__init__.py @@ -0,0 +1 @@ +# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file. diff --git a/.venv/Lib/site-packages/colorama/tests/__pycache__/__init__.cpython-312.pyc b/.venv/Lib/site-packages/colorama/tests/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8694fb17df1c9fd80fab35468b2920567ef0538e GIT binary patch literal 212 zcmZ9GJqp4=5QVe;fCxE=g~nD98%srP>;{%iGQ`y+yUc8aoWwJD7H=R}c>)PoSh;C^ z@aBDQm}2f>I1Ic#yJxoc`D)9*nx5ZWgE|3&`Ib_F? gl)BVT%89KXgGFJ|D#s=D{SU&MTX=Vc5Y+Yb13Ab&(EtDd literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/tests/__pycache__/ansi_test.cpython-312.pyc b/.venv/Lib/site-packages/colorama/tests/__pycache__/ansi_test.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..26da3c4b5065466020279693e456fec155629a08 GIT binary patch literal 5481 zcmeHL-A^1<6u+}GvpcXrODUFRQK@a!ZTaq6y0ocM*itOrHWX63Y% zXbcZEsfor%Leiv|m`HNsqNrUdA?=E~(qdE;h$d=M zN=nO7IqiD9A=9daJiF*i1x(l_EUdv-m zrQln`MM4prL}uI0aRvFZ$T{**hy>hLL)goTjhRY*L>#jo2LRoY6Bn zjhk5-OJ!$_*iDdXd~Qxn&(DT>VqLfO%plbZTRiho`4-yiATi%T7PNl z_gO4_XU~YK4+2IVW_?E)h#Y7SzH3(@U&Wq8p6 z-sZE=BnSAq(zu11COg36TUk{!w*x%xYE{uZ4)FLcRTWKffVcV6Yc&q=uT%{VrdI0! zZ^I~>*8#rOX8bw__%<7Sy#xGfHuwey_;wroJ_qMLjT8 zOFlm~ICRMp$HT*xJTe{*M=bY^@YvXu>yR^yO@=Mc<-w6~WMa^ghHeZ-EcyDy(TT7n zkB6^?C#?Fh(UFT2EQA{V!16K^LZQLiSV%M*SQ`(Gc3mDi8AfX#v+_fgnsG?9cq}$F zn7jV<2axG7w;41|nz%U+=7PWMuV3BhgOwY%fRYyp&n|?E3ka{VT~0rMJAFZ`rr<{)WLQ73O`qEaoF$VBHs3g_)nK@Y?t7Sod|T!t6s8eUGpEj<3S}`zySi>%PuaSOL!r z3UjdU%SYQ(PVe#R9Z&Kh@gbrj4N;gzexck+C&D*qwE8Uv5+BWqT9}D3+qCnRr@PRjXE2(^+jk zh4ngB#fu)^Lh*P;{V4ETqP-~a4&@f`C83z-Qg%Cn$2vZ*eyk0kz`Kt8UCCL#+;j9@@ZnXJF#=*s6a?WZsr{WC z`I8)7Cr6)ex3Xxx#)dds62O{75eUd{G5Q=`b;2F-MxjMMc=QI^7(}=kw~p< Gpnm{rZj8ME literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/tests/__pycache__/ansitowin32_test.cpython-312.pyc b/.venv/Lib/site-packages/colorama/tests/__pycache__/ansitowin32_test.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..81952c71d45cb64e187d416a5c27cfb10d9d1901 GIT binary patch literal 18020 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 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/tests/__pycache__/initialise_test.cpython-312.pyc b/.venv/Lib/site-packages/colorama/tests/__pycache__/initialise_test.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..023e90cd1194a93397981d5062311a06ddb67fef GIT binary patch literal 11668 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 E0L}XQtpET3 literal 0 HcmV?d00001 diff --git a/.venv/Lib/site-packages/colorama/tests/__pycache__/isatty_test.cpython-312.pyc b/.venv/Lib/site-packages/colorama/tests/__pycache__/isatty_test.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a104c98ced9002bcaf9fbbcbff4a0ecf1b5b1834 GIT binary patch literal 4795 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 i5f1&0Fu1a<$hRTO_AgZoUkk!{^1DE> 4) & 7 + self._style = value & (WinStyle.BRIGHT | WinStyle.BRIGHT_BACKGROUND) + + def reset_all(self, on_stderr=None): + self.set_attrs(self._default) + self.set_console(attrs=self._default) + self._light = 0 + + def fore(self, fore=None, light=False, on_stderr=False): + if fore is None: + fore = self._default_fore + self._fore = fore + # Emulate LIGHT_EX with BRIGHT Style + if light: + self._light |= WinStyle.BRIGHT + else: + self._light &= ~WinStyle.BRIGHT + self.set_console(on_stderr=on_stderr) + + def back(self, back=None, light=False, on_stderr=False): + if back is None: + back = self._default_back + self._back = back + # Emulate LIGHT_EX with BRIGHT_BACKGROUND Style + if light: + self._light |= WinStyle.BRIGHT_BACKGROUND + else: + self._light &= ~WinStyle.BRIGHT_BACKGROUND + self.set_console(on_stderr=on_stderr) + + def style(self, style=None, on_stderr=False): + if style is None: + style = self._default_style + self._style = style + self.set_console(on_stderr=on_stderr) + + def set_console(self, attrs=None, on_stderr=False): + if attrs is None: + attrs = self.get_attrs() + handle = win32.STDOUT + if on_stderr: + handle = win32.STDERR + win32.SetConsoleTextAttribute(handle, attrs) + + def get_position(self, handle): + position = win32.GetConsoleScreenBufferInfo(handle).dwCursorPosition + # Because Windows coordinates are 0-based, + # and win32.SetConsoleCursorPosition expects 1-based. + position.X += 1 + position.Y += 1 + return position + + def set_cursor_position(self, position=None, on_stderr=False): + if position is None: + # I'm not currently tracking the position, so there is no default. + # position = self.get_position() + return + handle = win32.STDOUT + if on_stderr: + handle = win32.STDERR + win32.SetConsoleCursorPosition(handle, position) + + def cursor_adjust(self, x, y, on_stderr=False): + handle = win32.STDOUT + if on_stderr: + handle = win32.STDERR + position = self.get_position(handle) + adjusted_position = (position.Y + y, position.X + x) + win32.SetConsoleCursorPosition(handle, adjusted_position, adjust=False) + + def erase_screen(self, mode=0, on_stderr=False): + # 0 should clear from the cursor to the end of the screen. + # 1 should clear from the cursor to the beginning of the screen. + # 2 should clear the entire screen, and move cursor to (1,1) + handle = win32.STDOUT + if on_stderr: + handle = win32.STDERR + csbi = win32.GetConsoleScreenBufferInfo(handle) + # get the number of character cells in the current buffer + cells_in_screen = csbi.dwSize.X * csbi.dwSize.Y + # get number of character cells before current cursor position + cells_before_cursor = csbi.dwSize.X * csbi.dwCursorPosition.Y + csbi.dwCursorPosition.X + if mode == 0: + from_coord = csbi.dwCursorPosition + cells_to_erase = cells_in_screen - cells_before_cursor + elif mode == 1: + from_coord = win32.COORD(0, 0) + cells_to_erase = cells_before_cursor + elif mode == 2: + from_coord = win32.COORD(0, 0) + cells_to_erase = cells_in_screen + else: + # invalid mode + return + # fill the entire screen with blanks + win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord) + # now set the buffer's attributes accordingly + win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord) + if mode == 2: + # put the cursor where needed + win32.SetConsoleCursorPosition(handle, (1, 1)) + + def erase_line(self, mode=0, on_stderr=False): + # 0 should clear from the cursor to the end of the line. + # 1 should clear from the cursor to the beginning of the line. + # 2 should clear the entire line. + handle = win32.STDOUT + if on_stderr: + handle = win32.STDERR + csbi = win32.GetConsoleScreenBufferInfo(handle) + if mode == 0: + from_coord = csbi.dwCursorPosition + cells_to_erase = csbi.dwSize.X - csbi.dwCursorPosition.X + elif mode == 1: + from_coord = win32.COORD(0, csbi.dwCursorPosition.Y) + cells_to_erase = csbi.dwCursorPosition.X + elif mode == 2: + from_coord = win32.COORD(0, csbi.dwCursorPosition.Y) + cells_to_erase = csbi.dwSize.X + else: + # invalid mode + return + # fill the entire screen with blanks + win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord) + # now set the buffer's attributes accordingly + win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord) + + def set_title(self, title): + win32.SetConsoleTitle(title) + + +def enable_vt_processing(fd): + if win32.windll is None or not win32.winapi_test(): + return False + + try: + handle = get_osfhandle(fd) + mode = win32.GetConsoleMode(handle) + win32.SetConsoleMode( + handle, + mode | win32.ENABLE_VIRTUAL_TERMINAL_PROCESSING, + ) + + mode = win32.GetConsoleMode(handle) + if mode & win32.ENABLE_VIRTUAL_TERMINAL_PROCESSING: + return True + # Can get TypeError in testsuite where 'fd' is a Mock() + except (OSError, TypeError): + return False diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/INSTALLER b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/INSTALLER new file mode 100644 index 0000000..a1b589e --- /dev/null +++ b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/METADATA b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/METADATA new file mode 100644 index 0000000..8800e61 --- /dev/null +++ b/.venv/Lib/site-packages/fastapi-0.115.11.dist-info/METADATA @@ -0,0 +1,565 @@ +Metadata-Version: 2.1 +Name: fastapi +Version: 0.115.11 +Summary: FastAPI framework, high performance, easy to learn, fast to code, ready for production +Author-Email: =?utf-8?q?Sebasti=C3=A1n_Ram=C3=ADrez?= +Classifier: Intended Audience :: Information Technology +Classifier: Intended Audience :: System Administrators +Classifier: Operating System :: OS Independent +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python +Classifier: Topic :: Internet +Classifier: Topic :: Software Development :: Libraries :: Application Frameworks +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: Software Development :: Libraries +Classifier: Topic :: Software Development +Classifier: Typing :: Typed +Classifier: Development Status :: 4 - Beta +Classifier: Environment :: Web Environment +Classifier: Framework :: AsyncIO +Classifier: Framework :: FastAPI +Classifier: Framework :: Pydantic +Classifier: Framework :: Pydantic :: 1 +Classifier: Framework :: Pydantic :: 2 +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +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: Topic :: Internet :: WWW/HTTP :: HTTP Servers +Classifier: Topic :: Internet :: WWW/HTTP +Project-URL: Homepage, https://github.com/fastapi/fastapi +Project-URL: Documentation, https://fastapi.tiangolo.com/ +Project-URL: Repository, https://github.com/fastapi/fastapi +Project-URL: Issues, https://github.com/fastapi/fastapi/issues +Project-URL: Changelog, https://fastapi.tiangolo.com/release-notes/ +Requires-Python: >=3.8 +Requires-Dist: starlette<0.47.0,>=0.40.0 +Requires-Dist: pydantic!=1.8,!=1.8.1,!=2.0.0,!=2.0.1,!=2.1.0,<3.0.0,>=1.7.4 +Requires-Dist: typing-extensions>=4.8.0 +Provides-Extra: standard +Requires-Dist: fastapi-cli[standard]>=0.0.5; extra == "standard" +Requires-Dist: httpx>=0.23.0; extra == "standard" +Requires-Dist: jinja2>=3.1.5; extra == "standard" +Requires-Dist: python-multipart>=0.0.18; extra == "standard" +Requires-Dist: email-validator>=2.0.0; extra == "standard" +Requires-Dist: uvicorn[standard]>=0.12.0; extra == "standard" +Provides-Extra: all +Requires-Dist: fastapi-cli[standard]>=0.0.5; extra == "all" +Requires-Dist: httpx>=0.23.0; extra == "all" +Requires-Dist: jinja2>=3.1.5; extra == "all" +Requires-Dist: python-multipart>=0.0.18; extra == "all" +Requires-Dist: itsdangerous>=1.1.0; extra == "all" +Requires-Dist: pyyaml>=5.3.1; extra == "all" +Requires-Dist: ujson!=4.0.2,!=4.1.0,!=4.2.0,!=4.3.0,!=5.0.0,!=5.1.0,>=4.0.1; extra == "all" +Requires-Dist: orjson>=3.2.1; extra == "all" +Requires-Dist: email-validator>=2.0.0; extra == "all" +Requires-Dist: uvicorn[standard]>=0.12.0; extra == "all" +Requires-Dist: pydantic-settings>=2.0.0; extra == "all" +Requires-Dist: pydantic-extra-types>=2.0.0; extra == "all" +Description-Content-Type: text/markdown + +